Hubs-Foundation / Hubs-Foundation/hubs-docs
"Updating Hubs" needs callout/more instructions RE community-edition folder
- Dominant language
- JavaScript
- Stars
- 28
- Forks
- 181
- Avg merge
- 13h 13m
- Merged PRs (30d)
- 1
Description
**Description of the issue**
In the "Updating Hubs" section, it is not super clear that Hubs instance owners _need to be in the community-edition folder_ in VS Code (or whatever command prompt system) in order for the specified command prompts to run. Also, this direction -- to be in the community-edition folder-- should be **more robust** in all other places in our docs even if we already direct it. As an example of what we currently do, see the Beginner's Guide, step 12, h. This location does NOT use a callout box, probably because this substep, h, is in the middle of Step 12 and we've assumed a user will simply continue along, unstopped and we've brought them to the community-edition folder earlier in the same instructions).
**Location of the issue**
So far, I've found 7 specific locations in the Setting Up Your Hub section:
In the Updating Hubs section of the What's next document:
1. [How to update your Hubs CE instance](https://docs.hubsfoundation.org/whats-next.html#how-to-update-your-hubs-ce-instance)
2. [How to update your Hubs CE deployment scripts (Git Version)](https://docs.hubsfoundation.org/whats-next.html#how-to-update-your-hubs-ce-deployment-scripts-git-version)
3. [After updating your Hubs CE deployment scripts](https://docs.hubsfoundation.org/whats-next.html#after-updating-your-hubs-ce-deployment-scripts)
In Updating the Beginner's Guide:
4. [12. Generate your config file](https://docs.hubsfoundation.org/beginners-guide-to-CE.html#12-generate-your-config-file) step h
In How to back up your Hubs instance:
5. [How to do a backup](https://docs.hubsfoundation.org/how-to-backup-your-Hubs-instance.html#how-to-do-a-backup)
6. [How to restore a backup](https://docs.hubsfoundation.org/how-to-backup-your-Hubs-instance.html#how-to-restore-a-backup)
In Regenerating SSL Certificates:
7. [How do I regenerate my certificates?](https://docs.hubsfoundation.org/regenerating-ssl-certificates.html#how-do-i-regenerate-my-certificates), step 1 and step 6
Expected result from remediation
A robust reminder for Hubs instance users that they must be in the community-edition folder in order for these command prompts to run.
Screenshots of the issue
Example from the What's Next document:

Hardware the issue was observed on
Device: Desktop
OS: Windows
Browser: Firefox
Additional context/notes
A. Perhaps add a purple (HEX 8256d0) callout box? Per our [Website Style Guide](https://docs.google.com/document/d/1qpqto-MqLBHSdVcq9ZqNOk8VpkFIZ6Pv/edit#heading=h.xt9t3uv8w83), purple is our "important" color. Upon looking at our current docs, we only have the yellow callout box type utilized with this code, so I am unsure if purple would look good OR be feasible. Might be something we need to test and consider:
Yellow callout box example : beginners-guide-to-CE.md, line 540:
> 💡 Tip: Make sure you are using your Scaleway Username and Secret Key, not your Access Key ID.
B. I believe that this section, [How to update your Hubs CE deployment scripts (Zip Version)](https://docs.hubsfoundation.org/whats-next.html#how-to-update-your-hubs-ce-deployment-scripts-zip-version) can be skipped for this issue since being in the community-edition folder is not relevant in order for the instructions to work, correct?
C. 7 places to fix = 7 expected PRs?
Contributor guide
Research direction
Review the seven linked locations in the What's Next, Beginner's Guide, backup, and SSL certificate documents, starting with the existing callout example in beginners-guide-to-CE.md around line 540. Check how the community-edition folder requirement is currently described, then make the reminder consistent in the listed locations and verify the Zip Version section is out of scope.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 72/100