From 7635905fb24394117489dc4c2c2a79e7fcdbcfef Mon Sep 17 00:00:00 2001
From: Random Penguin <25882519-randompenguin@users.noreply.gitlab.com>
Date: Fri, 7 Mar 2025 13:08:50 -0600
Subject: [PATCH] Update Home

---
 Home.md | 36 +++++++++++++++++++++++++++++++++++-
 1 file changed, 35 insertions(+), 1 deletion(-)

diff --git a/Home.md b/Home.md
index 063f5af..12070f6 100644
--- a/Home.md
+++ b/Home.md
@@ -406,4 +406,38 @@ _(Blame Google Translate if those translations are laughably wrong)_
 
 A good place for server admins to add the CSS variable block is in the "Frio" theme footer template file at _/friendica/view/templates/footer.tpl_ but you should put it inside a _Smarty3_ `{{literal}}<style>...</style>{{/literal}}` block at the end of that file. That way you will only need to re-do it when "Frio" or "Friendica" get updated, not every time there is a _Bookface_ update.
 
-End users can add the block as a user content stylesheet using either _userContent.css_ or the Stylus Add-On in Firefox, with the Stylus Extension in Google Chrome, or the Userscripts Extension in Safari.
\ No newline at end of file
+End users can add the block as a user content stylesheet using either _userContent.css_ or the Stylus Add-On in Firefox, with the Stylus Extension in Google Chrome, or the Userscripts Extension in Safari.
+
+# FILE BUTTON HIDDEN
+
+![File_Button_Hidden.png](uploads/59b691b2f55040069686d744005be4de/File_Button_Hidden.png)
+
+Some users may notice that when they switch to _Bookface_ the "File Attachment" button in the post Compose browser is **missing**.  This is _not_ a bug!  It was a UX design decision to **purposely** hide that button.  Why?
+
+There is no interface for actually managing the files you upload and attach. You cannot rename the files and you can't delete them. If you accidentally upload a private file you can't remove it.  It will accept several different file types, but uploaded videos have to be quite short due to file upload size limits, and even that limit is set rather high, file uploads will often fail. If you are attaching both photos and files the interface can appear to be in photo mode but upload the image as a file instead. Again, you can never delete files uploaded in error. You would have to contact the server administrator and have them manually delete the file for you.
+
+Users apparently aren't even _supposed_ to be using this feature, especially to upload videos. According to the Friendica GitHub account the [lead developer said](https://github.com/friendica/friendica/issues/9910#issuecomment-774543151): 
+
+> _"I'd suggest you use PeerTube to post video and reshare from your Friendica account since both support ActivityPub."_  
+
+Presumably people should also be sharing other types of files by uploading them to a cloud drive somewhere and sharing a link to the file rather than uploading them to their Friendica account.
+
+Years ago there was a video upload button and section in Friendica. Those were removed because none of the current core developers have experience handling video files \[[source](https://github.com/friendica/friendica/issues/9910#issuecomment-774713091)\]. They were replaced with the "Media" section but there is still no interface for _managing_ uploaded files.  Arguably if such an interface is not going to be added to Friendica, the File upload and attachment feature _should be removed_ as well.
+
+Bookface is intended to make Friendica friendlier to  users coming from other platforms. Rather than expose new users to this incomplete, partially-broken feature a design decision was made to _hide_ the button.
+
+## Showing the File Button
+
+![File_Button_visible.png](uploads/6fec0e4cda8d39d53a52f436e739e483/File_Button_visible.png)
+
+That said, _Bookface_ makes it easy for both Friendica Administrators or end-users to un-hide the button.  _Bookface_ hides the button with a CSS variable at the top of each stylesheet. The block discussed above in the "[Customization](#customization)" section. Simply change `--attach-file-button: none`; to `--attach-file-button: block;` and the button will reappear.
+
+Friendica Admins can either change this at the top of each of the server-side scheme stylesheets or they can add a customization `<style> `block to the "Frio" theme` footer.tpl` template file.  Friendica users on a server that offers Bookface can override the setting for themselves by adding a custom user stylesheet using one of the methods under "[Installing Bookface Userstyles](#installing-bookface-userstyles)" above.  It can be as simple as this one line:
+
+```
+:root{--attach-file-button: block;}
+```
+
+Friendica users who are using the Userstyles version of _Bookface_ can edit it at the top of their custom stylesheet.
+
+Switching Friendica to any other scheme or theme will also reveal the button. Only _Bookface_ hides it.
\ No newline at end of file