Skip to content

Commit d78b3da

Browse files
committed
Edit content to bring more up to date
1 parent 0b59d28 commit d78b3da

File tree

6 files changed

+18
-22
lines changed

6 files changed

+18
-22
lines changed

docs/community/community-guide.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,20 +8,25 @@ team!
88

99
There are a few resources that are particularly useful for team members. Here's
1010
a quick list to get you started.
11-
- devguide
12-
- docs
11+
12+
- [devguide](https://devguide.python.org)
13+
- [docs](https://docs.python.org)
1314
- python_docs_theme
1415
- discourse channel
15-
16+
- discord channel
1617

1718
### General information about communication channels
1819

1920
We are trying to organize our discussions in order to help both contributors and
2021
maintainers find and choose the right communication channels and have a positive experience :-)
2122

2223
In this respect, we are using:
23-
1. [BPO](https://bugs.python.org) and GitHub issues for specific discussions related to changing a repository's content. This is determined by doc project.
24+
25+
1. GitHub issues for specific discussions related to changing a repository's content.
2426
2. The [Discourse forum](http://discuss.python.org/) for general discussions, support
2527
questions, or just as a place where we can inspire each other.
2628

2729
## How can I help?
30+
31+
Read the devguide's section on documentation.
32+
Visit the Python repo's GitHub issues and look for issues tagged with `docs`.

docs/community/index.rst

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,4 +18,3 @@ The Documentation Community Team has a Code of Conduct
1818
contributing
1919
community-guide
2020
skills
21-
team

docs/community/skills.md

Lines changed: 3 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -4,24 +4,13 @@
44

55
The short answer to this question is: follow your interests :-)
66

7-
## A few general ways to help out
8-
9-
10-
### Python-specific knowledge
11-
12-
- **Code structure of the docs repository**
7+
The [Python Developer's Guide documentation](https://devguide.python.org/documentation) section is a good place to start.
8+
It's a comprehensive guide to the Python documentation and the tools we use to build it.
9+
It's a good idea to read through the guide to get a sense of the tools and processes we use.
1310

1411
## A note on complexity of tasks
1512

1613
Depth/expertise required for certain kinds of tasks can be hard to nail down and not at
1714
all obvious. If you'd like to make a contribution and you're not sure where to start,
1815
a good rule of thumb is to reach out to another team member to help
1916
you scope the work you'd like to do, and to set expectations.
20-
21-
## Links
22-
23-
24-
25-
## Resources for Learning
26-
27-
In this section, we gather some introductory materials for learning the aforementioned tools.

docs/community/team.rst

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,7 @@
1+
:orphan:
2+
3+
.. This page is retained solely for existing links.
4+
15
.. _doc_team:
26

37
==================

docs/editorial-board/index.rst

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,7 @@
44
Editorial Board
55
===============
66

7-
The acceptance of `PEP 732 <https://peps.python.org/pep-0732/>`_ established
8-
the Python Documentation Editorial Board.
7+
The acceptance of :pep:`732` established the Python Documentation Editorial Board.
98

109
Monthly Editorial Board Meetings
1110
================================

docs/monthly-meeting/index.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ Monthly Reports Archive
55

66
`Current agenda <https://hackmd.io/@encukou/pydocswg1>`_
77

8-
Monthly reports in reverse chronological order.
8+
Monthly reports in chronological order.
99

1010
.. toctree::
1111
:maxdepth: 1

0 commit comments

Comments
 (0)