pgadmin-org / pgadmin-org/pgadmin4

Docs: split Tabbed Browser to introduce Dashboard documentation

Open Beginner friendly
#10,157 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Feature
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:

  1. Create a new page for the Dashboard, as a copy of Tabbed Browser.
  2. Remove content unrelated to the Dashboard (the top paragraph and everything after this: "The Properties tab displays information about the object selected.").
  3. Add the "Dashboard" page right after "Tabbed Browser".
  4. 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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.