The Coordinators Handbook embedded a full Markdown issue template as a
code block for proposing new mentorship programs. This template now
lives as a proper Forgejo YAML issue form in the tickets repo
(mentored-projects/tickets#180), so the docs page replaces the 70+
line code block with a short paragraph pointing to the issue template.
Also updates the project proposal URL from the old GitLab.com Mentoring
Working Group Home repo to the Forge tickets repository.
Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
Adds a new "Keep your project independent of any specific applicant"
subsection to the Mentors Handbook under "Getting Started". Mentors are
advised not to propose projects built around a specific contributor,
because if that person cannot participate, the mentor is left committed
to a project they may not have proposed otherwise — and enthusiasm drops
at the worst possible time.
Also adds a corresponding "Watch for proposals tailored to a specific
applicant" subsection to the Coordinators Handbook, advising
coordinators to watch for signs of this pattern during proposal review
and discuss the risk directly with the mentor.
Closes: mentored-projects/tickets#178
Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
The earlier commit (130d87b) replaced the broken `{author}` attribute
references with a literal `:page-authors:` attribute, but also removed
the AsciiDoc author line (the semicolon-separated names after the
title). That line is what AsciiDoc parses as document-level author
metadata, which the Fedora Docs theme renders on the page. Without it,
authors stopped appearing entirely.
Restored the standard AsciiDoc author line in all four handbook pages
and removed the now-redundant `:page-authors:` custom attribute. The
built-in author line is the canonical source of author metadata — no
need for both.
Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
Proofreading pass across all four handbook pages. Fixes clear errors and
lightly tightens verbose passages for an international audience:
- `mentors.adoc`: "Hanbook" → "Handbook", "Handling over" → "Handing
over", "Outreachy program" → "Fedora Mentored Projects" (this is the
general handbook, not Outreachy-specific)
- `accepted-interns.adoc`: missing "with" in "Work your mentor", replace
"acclimatize" with simpler phrasing, tightened wordy intro and career
development paragraphs
- `coordinators.adoc`: removed duplicate word "proposal proposal"
- `tools.adoc`: "PRojects" → "Projects" capitalization typo
Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
CI warning targeted:
```
WARN (asciidoctor): section title out of sequence:
expected level 1, got level 2
```
The original MediaWiki-migrated markup used a non-standard title format
(text + underline dashes) and `===` level-3 headings without a level-1
parent. Replaced with a proper AsciiDoc `=` title and demoted `===` to
`==` to follow the right heading hierarchy under the new document title.
Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
Years with only one page (GSoC 2005–2009, 2011; GCI 2018) had
unnecessary directory nesting — clicking the year expanded a sub-menu
with just one link. This flattens those directories into single files
(e.g., `gsoc/2011/ideas.adoc` → `gsoc/2011.adoc`) so the year label
links directly to the page content.
Each moved file includes an Antora `:page-aliases:` attribute pointing
to the old path, generating URL redirects so existing bookmarks and
external links continue to work.
Also fixes GSoC 2020 nav indentation (sub-pages were at `***` instead of
`****`).
Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
CI errors targeted:
```
WARN (asciidoctor): unterminated example block
file: modules/ROOT/pages/gci/2018/tasks.adoc:8
ERROR (asciidoctor): dropping cells from incomplete row detected end of table
file: modules/ROOT/pages/gsoc/2016/ideas.adoc:496
```
GCI 2018 `tasks.adoc` line 8 had a `===========` delimiter (likely a
visual separator from the original Fedora Wiki migration) that AsciiDoc
interpreted as an example block opener, swallowing all content below it.
Removed the errant delimiter.
GSoC 2016 `ideas.adoc` had a table row missing its leading pipe
character (`IRC Channel |#atomic` → `|IRC Channel |#atomic`), causing an
incomplete row error at the table close.
Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
CI warning targeted:
```
WARN (asciidoctor): skipping reference to missing attribute: author
WARN (asciidoctor): skipping reference to missing attribute: author_2
WARN (asciidoctor): skipping reference to missing attribute: author_3
WARN (asciidoctor): skipping reference to missing attribute: author_4
```
These warnings appeared for all four handbook pages: accepted-interns,
coordinators, mentors, and tools.
The `:page-authors:` attribute referenced `{author}`, `{author_2}`, etc.
but these AsciiDoc document attributes are not defined until the author
line is parsed — after the attribute assignment. Replaced with literal,
alphabetized author names.
Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
CI error targeted:
```
ERROR (asciidoctor): target of xref not found: ideas.adoc
ERROR (asciidoctor): target of xref not found: schedule.adoc
ERROR (asciidoctor): target of xref not found: student_application_process.adoc
ERROR (asciidoctor): target of xref not found: application_process.adoc
ERROR (asciidoctor): target of xref not found: application.adoc
ERROR (asciidoctor): target of xref not found: outreachy/2020/index.adoc
ERROR (asciidoctor): target of xref not found: outreachy/2021/index.adoc
ERROR (asciidoctor): target of xref not found: gsoc/2008/index.adoc
```
Antora resolves `xref` targets from the module pages root, not the
current file's directory. Bare sibling xrefs like `xref:ideas.adoc[]`
inside `gsoc/2017/index.adoc` looked for `pages/ideas.adoc` instead of
`pages/gsoc/2017/ideas.adoc`.
This commit qualifies all ~45 bare xrefs across 14 GSoC pages (2010–
2018) and 2 Outreachy ideas pages with their full module-relative paths.
Also fixes `nav.adoc` where the 2007 GSoC entry incorrectly pointed to
`gsoc/2008/index.adoc` instead of `gsoc/2007/index.adoc`.
Assisted-by: Claude Opus 4.6 (1M context)
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit is a major reworking of the sidebar navigation. The sidebar
navigation has become difficult to navigate and find the most useful
information. So, a few things were changed:
1. Past projects for all programs are now sorted by decades, if the
program participation spans more than one decade. This makes some of
the sections load more quickly without making the user experience
worse with very lengthy, long lists in the sidebar nav.
2. Google Code-In and Google Season of Docs are moved to a new Retired
Programs section in the navigation. This more or less hides them from
view while also keeping them in plain sight. Now, they will not be
unfolded by default when navigating the main page or the other
program sections in the sidebar nav.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
When I initialized this repository, I did not realize I copied in an
older state of our docs. This commit fixes that, and pulls in all of the
content that exists on the latest version of the Fedora Mentored
Projects WG docs site. A lot of important and valuable work was
recovered!
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit adds a `.gitignore` file to the repository, adapted for a
Fedora Docs content repository project. This avoids directories created
by the development script to accidentally get committed to the project
by mistake.
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
This commit creates a new content repository for the Mentored Projects
Working Group documentation. This allows us to have a single, absolute
source of truth for all things documentation. This convention of using a
repository named "docs" follows an existing convention being used across
several Fedora Docs content repositories across the Fedora-verse.
This content was largely imported from the Mentored Projects WG Tickets
repo, where the tickets and docs were once bundled together into one.
This content will eventually be removed from the Tickets repo.
ref: https://forge.fedoraproject.org/mentored-projects/tickets
Signed-off-by: Justin Wheeler <jwheel@redhat.com>
