Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Split documentation into multiple pages. #722

Merged
merged 10 commits into from
Dec 26, 2024

Conversation

junkmd
Copy link
Collaborator

@junkmd junkmd commented Dec 26, 2024

See also #230.

The documentation's top page (index.rst) of the pythonhosted era primarily focused on client-side explanations.

While it’s true that client-side use cases represent the majority of this project’s usage, an overly large top page makes it difficult to grasp all the features the project provides.
In fact, the link to the server-side documentation had been buried and was hard to find.

To address this, I minimized the content on the top page and organized links.

Additionally, I noticed that the documentation once included a file called com_interfaces.txt(version 0.3.2 and version 0.4), which provided explanations about IUnknown and metaclasses.
Since the behavior of these components has largely remained unchanged, I decided to bring this information back, updating older styles as necessary.

There are still needs to modernize individual sections.
If the community could help with improvements, it is great.

@junkmd junkmd added the shared_info use cases, tips and troubleshoots label Dec 26, 2024
@junkmd junkmd added this to the 1.4.9 milestone Dec 26, 2024
junkmd added a commit to junkmd/pywinauto that referenced this pull request Dec 26, 2024
junkmd added a commit that referenced this pull request Dec 26, 2024
* Split `index.rst`.

* Modify `master_doc` in `conf.py`
to reflect the temporary file name change.
@junkmd junkmd force-pushed the rtd_split_revive_update branch from 40ca6e3 to 1ba03ed Compare December 26, 2024 14:04
junkmd added a commit that referenced this pull request Dec 26, 2024
* Remove duplicated, "NumPy" and "Threading" sections from `client.rst`.

* Remove client stuff from `main.rst`.
@junkmd junkmd force-pushed the rtd_split_revive_update branch from 1ba03ed to a83401d Compare December 26, 2024 14:32
junkmd added a commit that referenced this pull request Dec 26, 2024
* Rename the documentation file temporarily and make `npsupport.rst`.

* Revert temporarily renaming documentation file and make `threading.rst`.

* Revert `master_doc` in `conf.py`
to reflect the temporary module name change.
@junkmd junkmd force-pushed the rtd_split_revive_update branch from a83401d to d9accfa Compare December 26, 2024 14:58
junkmd added a commit that referenced this pull request Dec 26, 2024
* Remove duplicated stuff from `npsupport.rst`.

* Remove duplicated stuff from `threading.rst`.

* Remove duplicated stuff and improve `index.rst`.

* Update `Links` in `index.rst`.

* Add an article to `Links`.
@junkmd junkmd force-pushed the rtd_split_revive_update branch from d9accfa to d86b714 Compare December 26, 2024 15:15
@junkmd junkmd merged commit 49d819c into enthought:main Dec 26, 2024
50 checks passed
@junkmd junkmd deleted the rtd_split_revive_update branch December 26, 2024 15:36
junkmd added a commit to junkmd/pywinauto that referenced this pull request Dec 26, 2024
@junkmd junkmd linked an issue Jan 18, 2025 that may be closed by this pull request
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
shared_info use cases, tips and troubleshoots
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Documentation not up to date
1 participant