pgadmin-org / pgadmin-org/pgadmin4
Docs: split Tabbed Browser to introduce Dashboard documentation
Nobody has claimed this yet.
- Dominant language
- Python
- Stars
- 3.8k
- Forks
- 891
- Avg merge
- 4d 7h
- Merged PRs (30d)
- 8
Description
Describe the solution you'd like
Hi, I was looking for a description of Server sessions in the Dashboard, but was not able to quickly find it. It seems like it's "hidden" in the Tabbed Browser documentation, whose title is not obvious and which has no sections. Long docs like that make it harder to find things.
So this is the way I would improve the docs:
- Create a new page for the Dashboard, as a copy of Tabbed Browser.
- Remove content unrelated to the Dashboard (the top paragraph and everything after this: "The Properties tab displays information about the object selected.").
- Add the "Dashboard" page right after "Tabbed Browser".
- Add a link to "Dashboard documentation" in the "Tabbed Browser" (for those who have bookmarks). Then remove that section from the "Tabbed Browser" documentation.
I can do a pull request for that if that sounds OK.
Additional context
Also BTW. I would change this:
The Server sessions or Database sessions graph displays the interactions with the server or database.
To add clarification:
The Server sessions or Database sessions graph displays interactions with the server or database. Server sessions are the number of connections to the DBMS, some of which may be idle when connection pooling is enabled in some client applications.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the linked Tabbed Browser documentation and its navigation entry. Create the Dashboard page from the relevant content, place it after Tabbed Browser, add a link for existing bookmarks, remove the moved section, and apply the proposed clarification; done when the pages are separated and navigation is correct.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- postgresql
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Quiet
- Clarity
- Clearly specified
- Newbie friendliness
- 76/100