docs-community icon indicating copy to clipboard operation
docs-community copied to clipboard

Community management for documentation contributors and the Docs Workgroup

Results 20 docs-community issues
Sort by recently updated
recently updated
newest added

The changelog page is _very_ long: * https://docs.python.org/dev/whatsnew/changelog.html It's currently 219,974 words, that's longer than [_Moby Dick_](https://www.gutenberg.org/ebooks/2701) (212,794 words)... 🐳 It contains all the NEWS entries back to Python 3.5.0...

discussion

I would like to propose these activities for PyCon 2024, I know it is not relevant to the documentation for Python but I would like to get the opinion of...

meetings

https://github.com/python/cpython/pull/92199#discussion_r863506149: > It is not related to this PR, but if some item is mentioned multiple times in one paragrafph, I prefer to keep link only in one of them...

good first issue
help wanted
doc:styleguide

I have been browsing various documentation sites, as part of exploration for #1, and I quite like how React has handled their presentation for the documentation translations: https://reactjs.org/languages By having...

discussion

There seems to be general consensus that [diátaxis](https://diataxis.fr) is a great theoretical model for structuring documentation. However, using it – restructuring Python's docs – is a monumental task that needs...

task
doc:styleguide

From time to time the discussion arise about moving docs.python.org to readthedocs, there's even an experimental python.readthedocs.io. I think there's many pros and cons of using readthedocs. I'd personally be...

discussion

https://developers.google.com/search/docs/fundamentals/seo-starter-guide Google provides tool for analyzing your website performance: https://developers.google.com/search/docs/fundamentals/seo-starter-guide I think it needs the domain owner to do it, so perhaps someone from PSF infra team needs to look...

How to improve docs.python.org's SEO ranking? Come up with action items on how the SEO can be improved.

There's this open issue right now on British vs American spelling: https://github.com/python/cpython/issues/82221 In the past, there's been some merged PRs on similar smallish consistency/grammar issues: https://github.com/python/cpython/pull/2787 https://github.com/python/cpython/pull/25985 However, there are...

doc:styleguide

(This was discussed at one of the meetings, filing an issue so it isn't forgotten.) Any kind of reorganization can break existing URLs. Ideally any breakage is intentional rather than...