github-starred/actual
2
0
Fork 0
mirror of https://github.com/actualbudget/actual.git synced 2026-05-06 07:01:45 -05:00
Code Issues 1.5k Packages Projects Releases 54 Wiki Activity

[GH-ISSUE #7474] [Docs] Reorganize folders and sidebar in Docs #44748

New Issue
Open
opened 2026-04-26 06:38:08 -05:00 by GiteaMirror · 7 comments
GiteaMirror commented 2026-04-26 06:38:08 -05:00
Owner
Copy Link

Originally created by @Juulz on GitHub (Apr 11, 2026).
Original GitHub issue: https://github.com/actualbudget/actual/issues/7474

Issue Type

Documentation Improvement

Description

Looking for input on reorganizing the Docs sidebar and folders. (Contributing not to be changed)

In small PRs, sections will get fixed/added and this will also fix #6188

Adding a Quick Start Guide will be part of the project that will fix #6190

Screenshots of sidebar:

Image Image Image Image Image Image Image Image Image

Documentation URL

No response

Documentation Category

No response

Expected/Desired Content

No response

Screenshots or Examples

See above.
Originally created by @Juulz on GitHub (Apr 11, 2026). Original GitHub issue: https://github.com/actualbudget/actual/issues/7474 ### Issue Type Documentation Improvement ### Description Looking for input on reorganizing the Docs sidebar and folders. (Contributing not to be changed) In small PRs, sections will get fixed/added and this will also fix #6188 Adding a Quick Start Guide will be part of the project that will fix [#6190](https://github.com/actualbudget/actual/issues/6190) Screenshots of sidebar: <img width="325" height="1111" alt="Image" src="https://github.com/user-attachments/assets/5c5dcdb7-0d07-4909-adea-dec8cb241782" /> <img width="322" height="977" alt="Image" src="https://github.com/user-attachments/assets/6cdb9819-a25d-4252-b647-f3c9c9154dfd" /> <img width="326" height="1101" alt="Image" src="https://github.com/user-attachments/assets/5ff6f941-13ad-47ac-b26b-cc99175f8821" /> <img width="312" height="1114" alt="Image" src="https://github.com/user-attachments/assets/f702fc1c-a6f9-44e0-94c6-f0efc1433af6" /> <img width="317" height="1108" alt="Image" src="https://github.com/user-attachments/assets/ab2c9aba-4db8-4f18-a126-74c7b9c0108b" /> <img width="316" height="1110" alt="Image" src="https://github.com/user-attachments/assets/d451a191-dbd9-46fe-bcd2-3e70a52dfb04" /> <img width="321" height="1111" alt="Image" src="https://github.com/user-attachments/assets/0951c3f8-3946-4a0c-9545-8a5d0de684a7" /> <img width="310" height="1101" alt="Image" src="https://github.com/user-attachments/assets/fb9e3a91-7099-4012-8df2-49e6983cfbcb" /> <img width="300" height="1111" alt="Image" src="https://github.com/user-attachments/assets/fe43d0d6-c21c-4fc3-8f44-99f8b0472416" /> ### Documentation URL _No response_ ### Documentation Category _No response_ ### Expected/Desired Content _No response_ ### Screenshots or Examples ```bash See above. ```
GiteaMirror added the documentation label 2026-04-26 06:38:08 -05:00
GiteaMirror commented 2026-04-26 06:38:11 -05:00
Author
Owner
Copy Link

@Juulz commented on GitHub (Apr 11, 2026):

Here's what I wrote on the netlify-fail PR:

This is a revamped outline of what I think the sidebar of Docs should look like.
In my local files, I have moved most of the files to their respective sidebar folder locations, including experimental features. The docs are currently located kinda all over the place.

To make experimental feature docs easier in the future, IMO, experimental feature docs should go to their respective end-place in the sidebar and be put in their final folder when introduced. A ToC of experimental features gets added to the experimental index that lives in the settings folder (this is not done yet).

The changes will come in small PRs as they get completed.

What say you?

<!-- gh-comment-id:4230207959 --> @Juulz commented on GitHub (Apr 11, 2026): Here's what I wrote on the netlify-fail PR: This is a revamped outline of what I think the sidebar of Docs should look like. In my local files, I have moved most of the files to their respective sidebar folder locations, including experimental features. The docs are currently located kinda all over the place. To make experimental feature docs easier in the future, IMO, experimental feature docs should go to their respective end-place in the sidebar and be put in their final folder when introduced. A ToC of experimental features gets added to the experimental index that lives in the settings folder (this is not done yet). The changes will come in small PRs as they get completed. What say you?
GiteaMirror commented 2026-04-26 06:38:13 -05:00
Author
Owner
Copy Link

@bpaulien commented on GitHub (Apr 13, 2026):

It looks like a good, logical layout. Kinda stepping people through in the order they need to set up stuff to get it up and running in a logical order. First glance over looks good.

<!-- gh-comment-id:4233160976 --> @bpaulien commented on GitHub (Apr 13, 2026): It looks like a good, logical layout. Kinda stepping people through in the order they need to set up stuff to get it up and running in a logical order. First glance over looks good.
GiteaMirror commented 2026-04-26 06:38:15 -05:00
Author
Owner
Copy Link

@StephenBrown2 commented on GitHub (Apr 13, 2026):

I wonder if there could be a superscript (exp) (or without parens: exp) on pages for experimental features while they're experiemental, now that they're getting mixed in with the rest of the docs?

I noticed a bit of duplication in the proposed outline. While I'm not against some duplication for ease of use, I am more in favor of one place to find something, which also means only one place to update.

For example, "Tracking Budget" has two pages: one top level, one under Budgeting. Since it's not the recommended path, should we remove the top-level page, or just have the top level link to the other?

Under "Quick Start Guide", I realize it's not done yet, but I'm not sure if the subpages will be just links or brief summaries of their respective pages elsewhere in the docs (-> Link, > Nested):

  • "Install Actual" -> "Installation & Configuration"
  • "Add Accounts" -> "Adding Accounts" > "Add Accounts"
  • "Add Categories" -> "Budgeting" > "Categories"
  • "Add Transactions" -> "Transactions"
  • "Reconcile All Accounts" should maybe be named "Reconciling Accounts", -> "Adding Accounts" > "Reconciliation"
  • "Starting Fresh" -> "Budgeting" > "Restarting Your Budget"
  • "Starting a New Month" should go before "Starting Fresh", Should have a page under Budgeting to link to

The top level "Adding Accounts" should just be "Accounts", to align with top level "Transactions", and not have three places where "Add(ing) Accounts" is listed

Under Accounts:

  • "Accounts" > "Credit Cards":
    • I think we should put "Paying in Full" before "Carrying Debt", again favoring the recommended path first
  • I don't think the full title "Strategies for Handling Joint Accounts" in the sidebar, just "Joint Accounts" would do, unless it's required to use the full title from the page in the sidebar.

Under Transactions, I would order the items like this:

  • Payees
  • Filtering Transactions
  • Bulk Actions
  • Split Transactions
  • Transfers
  • Duplicate Transactions
  • Tags (Could be moved after Payees, as well)
  • Rules
    • ...

Under Budgeting:

  • "Budget Templates" should probably go before "End of Month Cleanup"
  • "Restarting Your Budget" is the same as "Starting Fresh", yes?
  • Again I would move "Tracking Budget" to the end of the list

Under Reports:

  • "Excel Formula Mode..." should be renamed "Formula cards" and split from "Rule formulas", which would then go under "Transactions" > "Rules". An unfortunate side effect of putting the experimental features into the mix of the rest, IMO.

Under "Utilities & Troubleshooting"

  • "Frequently Asked Questions" should be a tippy-top level item. I would put it right after "Release Notes" personally. It's in a good spot in the current outline, under "Help & Support".
  • "Restarting Your budget" is duplicated here, should stay only under "Budgeting"
  • "Backups" should be it's own second-level item, over both "Backing up" and "Restoring"
  • "Settings" seems like it should go under "Installation & configuration" though I realize that is more focused on the server side.
  • "Troubleshooting Server Configuration Issues" could also be shortened to "Server Configuration Issues" since it's under "Troubleshooting" already
<!-- gh-comment-id:4236964576 --> @StephenBrown2 commented on GitHub (Apr 13, 2026): I wonder if there could be a superscript <sup>(exp)</sup> (or without parens: <sup>exp</sup>) on pages for experimental features while they're experiemental, now that they're getting mixed in with the rest of the docs? I noticed a bit of duplication in the proposed outline. While I'm not against some duplication for ease of use, I am more in favor of one place to find something, which also means only one place to update. For example, "Tracking Budget" has two pages: one top level, one under Budgeting. Since it's not the recommended path, should we remove the top-level page, or just have the top level link to the other? Under "Quick Start Guide", I realize it's not done yet, but I'm not sure if the subpages will be just links or brief summaries of their respective pages elsewhere in the docs (`->` Link, `>` Nested): - "Install Actual" -> "Installation & Configuration" - "Add Accounts" -> "Adding Accounts" > "Add Accounts" - "Add Categories" -> "Budgeting" > "Categories" - "Add Transactions" -> "Transactions" - "Reconcile All Accounts" should maybe be named "Reconciling Accounts", -> "Adding Accounts" > "Reconciliation" - "Starting Fresh" -> "Budgeting" > "Restarting Your Budget" - "Starting a New Month" should go before "Starting Fresh", Should have a page under Budgeting to link to The top level "Adding Accounts" should just be "Accounts", to align with top level "Transactions", and not have three places where "Add(ing) Accounts" is listed Under Accounts: - "Accounts" > "Credit Cards": - I think we should put "Paying in Full" before "Carrying Debt", again favoring the recommended path first - I don't think the full title "Strategies for Handling Joint Accounts" in the sidebar, just "Joint Accounts" would do, unless it's required to use the full title from the page in the sidebar. Under Transactions, I would order the items like this: - Payees - Filtering Transactions - Bulk Actions - Split Transactions - Transfers - Duplicate Transactions - Tags (Could be moved after Payees, as well) - Rules - ... Under Budgeting: - "Budget Templates" should probably go before "End of Month Cleanup" - "Restarting Your Budget" is the same as "Starting Fresh", yes? - Again I would move "Tracking Budget" to the end of the list Under Reports: - "Excel Formula Mode..." should be renamed "Formula cards" and split from "Rule formulas", which would then go under "Transactions" > "Rules". An unfortunate side effect of putting the experimental features into the mix of the rest, IMO. Under "Utilities & Troubleshooting" - "Frequently Asked Questions" should be a tippy-top level item. I would put it right after "Release Notes" personally. It's in a good spot in the current outline, under "Help & Support". - "Restarting Your budget" is duplicated here, should stay only under "Budgeting" - "Backups" should be it's own second-level item, over both "Backing up" and "Restoring" - "Settings" seems like it should go under "Installation & configuration" though I realize that is more focused on the server side. - "Troubleshooting Server Configuration Issues" could also be shortened to "Server Configuration Issues" since it's under "Troubleshooting" already
GiteaMirror commented 2026-04-26 06:38:17 -05:00
Author
Owner
Copy Link

@Juulz commented on GitHub (Apr 13, 2026):

The Quick Start Guide fixes Issue #6190 - Create an opinionated guide. It will not just be links to other docs but a fresh start for new users giving only desktop or pikapods as install choices.

I ordered the transaction section in the order that new users actually use them and ask questions about them. Convince me! 😀 I have only used "Bulk Actions" once. I use split transactions, merging dupes, filters and schedules almost daily. As long as things are findable and in an expected place (or two).

The sidebar currently uses the title from the doc. That can get changed - some of them are very wordy.

Any doc that is in two places (looking at you tracking budget) will have a main home and the secondary spot will not be part of the next/previous flow at the page bottom.

Starting Fresh is not the same as restarting. 😁

I have no problem putting a page in two places! I would rather they be found than hidden.

The superscript idea for experimental features is a good one. I'll test that. My thought was that the index page for experimental features would explain them generally as now and have a current list of links to docs and feedback. Moving them out of experimental should be much easier as the docs will need a bit of editing, but the structure will be in place.

CC Paying in Full does come first in the sidebar now and that will not change.

I thought that Backup & Restore was a collapsed item. I guess it broke out of it's pen. LOL

Because I used current pages, some of the names are not really descriptive of the text. Some long docs will need to get split out.

The Quick Start Guide will hopefully never have to be referenced again - it is not be meant to be a repository of info that is not described in detail elsewhere. It's just for onboarding. If it links to other pages, they will open a new window so the new user doesn't lose their place in the Guide.

This is a really big project as there are LOTS of broken links from moving things into their correct folders. I am hoping when it's done, we will be able to have docusaurus auto-generate the sidebar so it won't have to be maintained anymore.

<!-- gh-comment-id:4237209081 --> @Juulz commented on GitHub (Apr 13, 2026): The Quick Start Guide fixes Issue #6190 - Create an opinionated guide. It will not just be links to other docs but a fresh start for new users giving only desktop or pikapods as install choices. I ordered the transaction section in the order that new users actually use them and ask questions about them. Convince me! 😀 I have only used "Bulk Actions" once. I use split transactions, merging dupes, filters and schedules almost daily. As long as things are findable and in an expected place (or two). The sidebar currently uses the title from the doc. That can get changed - some of them are very wordy. Any doc that is in two places (looking at you tracking budget) will have a main home and the secondary spot will not be part of the next/previous flow at the page bottom. Starting Fresh is not the same as restarting. 😁 I have no problem putting a page in two places! I would rather they be found than hidden. The superscript idea for experimental features is a good one. I'll test that. My thought was that the index page for experimental features would explain them generally as now and have a current list of links to docs and feedback. Moving them out of experimental should be much easier as the docs will need a bit of editing, but the structure will be in place. CC Paying in Full does come first in the sidebar now and that will not change. I thought that Backup & Restore was a collapsed item. I guess it broke out of it's pen. LOL Because I used current pages, some of the names are not really descriptive of the text. Some long docs will need to get split out. The Quick Start Guide will hopefully never have to be referenced again - it is not be meant to be a repository of info that is not described in detail elsewhere. It's just for onboarding. If it links to other pages, they will open a new window so the new user doesn't lose their place in the Guide. This is a really big project as there are LOTS of broken links from moving things into their correct folders. I am hoping when it's done, we will be able to have docusaurus auto-generate the sidebar so it won't have to be maintained anymore.
GiteaMirror commented 2026-04-26 06:38:20 -05:00
Author
Owner
Copy Link

@StephenBrown2 commented on GitHub (Apr 13, 2026):

I ordered the transaction section in the order that new users actually use them and ask questions about them. Convince me! 😀 I have only used "Bulk Actions" once. I use split transactions, merging dupes, filters and schedules almost daily. As long as things are findable and in an expected place (or two).

Fair point, I ordered them as I would consider them, though admittedly Bulk Actions could be moved down, I think it would be helpful to surface earlier users as it would help answer some questions I've seen come up.

Starting Fresh is not the same as restarting. 😁

https://actualbudget.org/docs/advanced/restart

Restarting Your Budget

If you've fallen behind on your budgeting and want to start fresh without starting from scratch.

https://actualbudget.org/docs/getting-started/starting-fresh

Starting Fresh

For most users it's best to start fresh with a blank file. ... without migrating from a previous budget software export.

Also fair, though they are very close, and even use the same term "start fresh", so I would recommend differentiating them more, but I recognize that's not what this reorg is for.

I have no problem putting a page in two places! I would rather they be found than hidden.

Me neither! But they should be a link to the same content, so that maintenance is easier and one doesn't get out of sync with the other, unless one is a summary pointing to the other, like with the new QSG.

I am hoping when it's done, we will be able to have docusaurus auto-generate the sidebar so it won't have to be maintained anymore.

That would be great, but I don't know how feasible it would be. :-)

<!-- gh-comment-id:4237604883 --> @StephenBrown2 commented on GitHub (Apr 13, 2026): > I ordered the transaction section in the order that new users actually use them and ask questions about them. Convince me! 😀 I have only used "Bulk Actions" once. I use split transactions, merging dupes, filters and schedules almost daily. As long as things are findable and in an expected place (or two). Fair point, I ordered them as I would consider them, though admittedly Bulk Actions could be moved down, I think it would be helpful to surface earlier users as it would help answer some questions I've seen come up. > Starting Fresh is not the same as restarting. 😁 >> https://actualbudget.org/docs/advanced/restart >> ## Restarting Your Budget >> > If you've fallen behind on your budgeting and want to **start fresh** without starting from scratch. >> https://actualbudget.org/docs/getting-started/starting-fresh >> ## Starting Fresh >> > For most users it's best to **start fresh** with a blank file. ... without migrating from a previous budget software export. Also fair, though they are _very_ close, and even use the same term "start fresh", so I would recommend differentiating them more, but I recognize that's not what this reorg is for. > I have no problem putting a page in two places! I would rather they be found than hidden. Me neither! But they should be a link to the _same content_, so that maintenance is easier and one doesn't get out of sync with the other, unless one is a summary pointing to the other, like with the new QSG. > I am hoping when it's done, we will be able to have docusaurus auto-generate the sidebar so it won't have to be maintained anymore. That would be great, but I don't know how feasible it would be. :-)
GiteaMirror commented 2026-04-26 06:38:22 -05:00
Author
Owner
Copy Link

@StephenBrown2 commented on GitHub (Apr 13, 2026):

Cursor was able to do the experimental notation in not much code, details over in the PR: https://github.com/actualbudget/actual/pull/7472#issuecomment-4238089404

<!-- gh-comment-id:4238093823 --> @StephenBrown2 commented on GitHub (Apr 13, 2026): Cursor was able to do the experimental notation in not much code, details over in the PR: https://github.com/actualbudget/actual/pull/7472#issuecomment-4238089404
GiteaMirror commented 2026-04-26 06:38:24 -05:00
Author
Owner
Copy Link

@Juulz commented on GitHub (Apr 13, 2026):

Cursor was able to do the experimental notation in not much code, details over in the PR: https://github.com/actualbudget/actual/pull/7472/commits#issuecomment-4238089404

Thanks a bunch! Visiting out of town for a couple of days. I'll get back to docs later this week.

<!-- gh-comment-id:4238578059 --> @Juulz commented on GitHub (Apr 13, 2026): > Cursor was able to do the experimental notation in not much code, details over in the PR: https://github.com/actualbudget/actual/pull/7472/commits#issuecomment-4238089404 Thanks a bunch! Visiting out of town for a couple of days. I'll get back to docs later this week.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
AI generated
API
bank sync
budgeting
bug
can’t replicate
dependencies
docker
documentation
electron
experimental feature
feature
feedback
goal templates
good first issue
help wanted
importers
maintenance
needs info
needs testing
needs triage
needs votes
openid
payees
pull-request
Mirrored from GitHub Pull Request
 regression
reports
responsive
rules
schedules
server
✨ merged
split transactions
tech debt
theme
transaction import
transaction reconciliation
transactions
translations
upstream
user interface
✅ approved
wontfix
No Label documentation
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
GiteaMirror ninjasurge
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/actual#44748
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?