mentored-projects/docs
mentored-projects/docs
SHA256
14
1
Fork 0
Code Issues Pull requests Activity Actions

🐛 docs(xrefs): Fix broken xref cross-references

Browse source 
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 contained in:
Justin Wheeler 2026-07-03 01:29:11 -04:00
commit 086bc0d8e3
Signed by: jflory7
GPG key ID: 7748B15FA8FA4C7E
17 changed files with 44 additions and 44 deletions
Download patch file Download diff file Expand all files Collapse all files

2
modules/ROOT/nav.adoc
View file

@ -66,7 +66,7 @@
*** 2008
**** xref:gsoc/2008/ideas.adoc[Ideas]
*** 2007
**** xref:gsoc/2008/index.adoc[Information]
**** xref:gsoc/2007/index.adoc[Information]
*** 2006
**** xref:gsoc/2006/index.adoc[Information]
*** 2005

10
modules/ROOT/pages/gsoc/2010/index.adoc
View file

@ -12,10 +12,10 @@ __TOC__
[[general-information]]
== General information
The xref:schedule.adoc[Summer Coding 2010 schedule] has
The xref:gsoc/2010/schedule.adoc[Summer Coding 2010 schedule] has
the timeline of events.
The page xref:index[Summer Coding 2010]
The page xref:gsoc/2010/index.adoc[Summer Coding 2010]
is the central location to find information about the program.
[[you-are-a-student]]
@ -85,7 +85,7 @@ your way around and figuring things out.
=== Do you want to start from ideas mentors already have?
Mentors and sub-projects have put up sections on the
xref:ideas.adoc[Summer Coding 2010 ideas] page. There you
xref:gsoc/2010/ideas.adoc[Summer Coding 2010 ideas] page. There you
can find:
* Full ideas that you might want to start on;
@ -179,7 +179,7 @@ invited to join the private mentor discussion list
[[what-to-do-with-your-ideas]]
=== What to do with your ideas
Put them here on the : xref:ideas.adoc[Summer Coding
Put them here on the : xref:gsoc/2010/ideas.adoc[Summer Coding
ideas] page. Reference
link:https://fedoraproject.org/wiki/How_to_create_an_idea_page_for_Summer_Coding[How to create an idea
page for Summer Coding] when creating your idea.
@ -375,7 +375,7 @@ mentor.
=== Do you have one or more ideas you want exposed to students?
As long as the idea is relevant for the Fedora Summer Coding program,
you can put it on the xref:ideas.adoc[Summer Coding 2010
you can put it on the xref:gsoc/2010/ideas.adoc[Summer Coding 2010
ideas] page. Follow the process on that page.
As this is a program for the Fedora Project and JBoss.org, there must be

6
modules/ROOT/pages/gsoc/2012/index.adoc
View file

@ -16,7 +16,7 @@ the worlds' leading and innovative Linux Distro, this could be the
chance. Please feel free to contact and refer to the material and start
contacting mentors.
1. xref:ideas.adoc[Main Idea Page]
1. xref:gsoc/2012/ideas.adoc[Main Idea Page]
[[why-spend-your-summer-working-on-foss]]
=== Why spend your summer working on FOSS?
@ -99,7 +99,7 @@ proposing an idea but still want to support the program please check the
students' idea page and pick one as per your interest.
1. http://en.flossmanuals.net/GSoCMentoring/[Manual on Mentoring]
2. xref:ideas.adoc[Main Idea Page]
2. xref:gsoc/2012/ideas.adoc[Main Idea Page]
3. link:https://fedoraproject.org/wiki/Summer_coding_ideas_for_2012/Students_Idea[Students' Idea page]
[[how-to-work-with-students]]
@ -243,7 +243,7 @@ link:https://fedoraproject.org/wiki/GSoC_2012_org_application[application]
*Status :* Open for Ideas +
*Link :*
xref:ideas.adoc[ideas]
xref:gsoc/2012/ideas.adoc[ideas]
We encourage students to provide creative yet useful ideas towards the
Fedora project as well. Please use

8
modules/ROOT/pages/gsoc/2013/index.adoc
View file

@ -16,7 +16,7 @@ the worlds' leading and innovative Linux Distro, this could be the
chance. Please feel free to contact and refer to the material and start
contacting mentors.
1. xref:ideas.adoc[Main Idea Page]
1. xref:gsoc/2013/ideas.adoc[Main Idea Page]
[[why-spend-your-summer-working-on-foss]]
=== Why spend your summer working on FOSS?
@ -75,7 +75,7 @@ students].
Please refer to the following to follow the students' application
process,
xref:student_application_process.adoc[Student Application Process]
xref:gsoc/2013/student_application_process.adoc[Student Application Process]
[[administration]]
== Administration
@ -98,7 +98,7 @@ proposing an idea but still want to support the program please check the
students' idea page and pick one as per your interest.
1. http://en.flossmanuals.net/GSoCMentoring/[Manual on Mentoring]
2. xref:ideas.adoc[Main Idea Page]
2. xref:gsoc/2013/ideas.adoc[Main Idea Page]
[[how-to-work-with-students]]
=== How to work with students
@ -227,7 +227,7 @@ is it still opened?
////
*Status :* Open for Ideas +
*Link :*
xref:ideas.adoc[ideas]
xref:gsoc/2013/ideas.adoc[ideas]
We encourage students to provide creative yet useful ideas towards the
Fedora project as well. Please use

8
modules/ROOT/pages/gsoc/2014/index.adoc
View file

@ -15,7 +15,7 @@ the worlds' leading and innovative Linux Distro, this could be the
chance. Please feel free to contact and refer to the material and start
contacting mentors.
1. xref:ideas.adoc[Main Idea Page]
1. xref:gsoc/2014/ideas.adoc[Main Idea Page]
[[why-spend-your-summer-working-on-foss]]
=== Why spend your summer working on FOSS?
@ -78,7 +78,7 @@ students].
Please refer to the following to follow the students' application
process,
xref:student_application_process.adoc[Student_Application_Process]
xref:gsoc/2014/student_application_process.adoc[Student_Application_Process]
[[administration]]
== Administration
@ -101,7 +101,7 @@ proposing an idea but still want to support the program please check the
students' idea page and pick one as per your interest.
1. http://en.flossmanuals.net/GSoCMentoring/[Manual on Mentoring]
2. xref:ideas.adoc[Main Idea Page]
2. xref:gsoc/2014/ideas.adoc[Main Idea Page]
[[how-to-work-with-students]]
=== How to work with students
@ -227,7 +227,7 @@ provided forms and evaluations are on file.
*Status :* Done +
*Link :* xref:ideas.adoc[Summer coding ideas for 2014]
*Link :* xref:gsoc/2014/ideas.adoc[Summer coding ideas for 2014]
We encourage students to provide creative yet useful ideas towards the
Fedora project as well. Please use

8
modules/ROOT/pages/gsoc/2015/index.adoc
View file

@ -15,7 +15,7 @@ the worlds' leading and innovative Linux Distro, this could be the
chance. Please feel free to contact and refer to the material and start
contacting mentors.
1. xref:ideas.adoc[Main Idea Page]
1. xref:gsoc/2015/ideas.adoc[Main Idea Page]
[[why-spend-your-summer-working-on-foss]]
=== Why spend your summer working on FOSS?
@ -77,7 +77,7 @@ students].
Please refer to the following to follow the students' application
process,
xref:student_application_process.adoc[Student Application Process]
xref:gsoc/2015/student_application_process.adoc[Student Application Process]
[[administration]]
== Administration
@ -101,7 +101,7 @@ proposing an idea but still want to support the program please check the
students' idea page and pick one as per your interest.
1. http://en.flossmanuals.net/GSoCMentoring/[Manual on Mentoring]
2. xref:ideas.adoc[Main Idea Page]
2. xref:gsoc/2015/ideas.adoc[Main Idea Page]
[[how-to-work-with-students]]
=== How to work with students
@ -248,7 +248,7 @@ provided forms and evaluations are on file.
*Status :* Open for Ideas +
*Link :* xref:ideas.adoc[Summer coding ideas for 2015]
*Link :* xref:gsoc/2015/ideas.adoc[Summer coding ideas for 2015]
We encourage students to provide creative yet useful ideas towards the
Fedora project as well. Please use

2
modules/ROOT/pages/gsoc/2015/student_application_process.adoc
View file

@ -32,7 +32,7 @@ deadline unless otherwise specifically noted.
link:https://admin.fedoraproject.org/mailman/devel[Devel Mailing List]
* Chose a project for proposal from
xref:ideas.adoc[Summer_coding_ideas_for_2016]
xref:gsoc/2015/ideas.adoc[Summer_coding_ideas_for_2016]
* Submit application/proposal on Google-Melange
link:https://summerofcode.withgoogle.com/get-started/[Google Melange

8
modules/ROOT/pages/gsoc/2016/index.adoc
View file

@ -16,7 +16,7 @@ the world's most leading and innovative Linux distribution, this could
be the chance. Please feel free to contact and refer to the material and
start contacting mentors.
1. xref:ideas.adoc[Main Idea Page]
1. xref:gsoc/2016/ideas.adoc[Main Idea Page]
[[why-spend-your-summer-working-on-foss]]
=== Why spend your summer working on FOSS?
@ -74,7 +74,7 @@ students].
Please refer to the following to follow the students' application
process,
1. xref:student_application_process.adoc[Student Application
1. xref:gsoc/2016/student_application_process.adoc[Student Application
Process]
[[administration]]
@ -98,7 +98,7 @@ proposing an idea but still want to support the program, please check
the students' idea page and pick one as per your interest.
1. link:http://en.flossmanuals.net/GSoCMentoring/[Manual on Mentoring]
2. xref:ideas.adoc[Main Idea Page]
2. xref:gsoc/2016/ideas.adoc[Main Idea Page]
[[how-to-work-with-students]]
=== How to work with students
@ -226,7 +226,7 @@ better and to make new friends too!
== Ideas Page
* *Status :* Open for Ideas +
* *Link :* xref:ideas.adoc[Summer coding ideas for
* *Link :* xref:gsoc/2016/ideas.adoc[Summer coding ideas for
2016]
[[links]]

2
modules/ROOT/pages/gsoc/2016/student_application_process.adoc
View file

@ -32,7 +32,7 @@ Coding Mailing List]
link:https://admin.fedoraproject.org/mailman/devel[Devel Mailing List]
* Chose a project for proposal from
xref:ideas.adoc[Summer_coding_ideas_for_2016]
xref:gsoc/2016/ideas.adoc[Summer_coding_ideas_for_2016]
* Submit application/proposal on Google-Melange
link:https://summerofcode.withgoogle.com/get-started/[Google Melange

2
modules/ROOT/pages/gsoc/2017/application_process.adoc
View file

@ -85,7 +85,7 @@ printouts from the wiki.
==== Supplemental Application Materials on the Fedora Project Wiki
Chose a project for proposal from
xref:ideas.adoc[Summer_coding_ideas_for_2017].
xref:gsoc/2017/ideas.adoc[Summer_coding_ideas_for_2017].
While it is possible to propose your own project, it is often more
successful for you to select one that is already proposed by a mentor.

4
modules/ROOT/pages/gsoc/2017/ideas.adoc
View file

@ -1,5 +1,5 @@
Find an idea you like? Want to propose your own? See the
xref:application_process.adoc[student application process].
xref:gsoc/2017/application_process.adoc[student application process].
[[students-welcome]]
== Students Welcome
@ -22,7 +22,7 @@ with programming problems.
If you are new to the Fedora Project, the following material will help
you to get started. You should also follow the
xref:application_process.adoc[student application process]
xref:gsoc/2017/application_process.adoc[student application process]
* link:https://docs.fedoraproject.org/fedora-project/project/fedora-overview.html[The Four Foundations of Fedora]
* link:https://developers.google.com/open-source/gsoc/resources/[Official

10
modules/ROOT/pages/gsoc/2017/index.adoc
View file

@ -39,7 +39,7 @@ Do you want to contribute to one of the world's leading and innovative
Linux distributions? GSoC could be your chance. Please refer to the
material below and start contacting mentors.
* xref:ideas.adoc[Ideas]
* xref:gsoc/2017/ideas.adoc[Ideas]
[[why-spend-your-summer-working-on-foss]]
=== Why spend your summer working on FOSS?
@ -108,7 +108,7 @@ Your responsibilities include:
=== Student Application
Please read and follow the
xref:application_process.adoc[student application process].
xref:gsoc/2017/application_process.adoc[student application process].
[[mentors]]
== Mentors
@ -127,7 +127,7 @@ projects.
1. link:http://write.flossmanuals.net/gsoc-mentoring/what-makes-a-good-mentor[Manual
on Mentoring]
2. xref:ideas.adoc[Main Idea Page and Supporting
2. xref:gsoc/2017/ideas.adoc[Main Idea Page and Supporting
Mentor List]
[[how-to-work-with-students]]
@ -180,7 +180,7 @@ Your responsibilities include:
[[list-of-mentors]]
=== List of Mentors
Mentors are listed on the xref:ideas.adoc[Main Idea Page and Supporting Mentor List]
Mentors are listed on the xref:gsoc/2017/ideas.adoc[Main Idea Page and Supporting Mentor List]
[[communication]]
== Communication
@ -256,7 +256,7 @@ projects.
== Ideas Page
* *Status :* Open for Ideas +
* *Link :* xref:ideas.adoc[Summer coding ideas for 2017]
* *Link :* xref:gsoc/2017/ideas.adoc[Summer coding ideas for 2017]
[[links]]
== Links

2
modules/ROOT/pages/gsoc/2018/application.adoc
View file

@ -73,7 +73,7 @@ In addition to the information Google requests, the Fedora Project
requires you to submit the following information:
* What project are you applying to? Seriously consider choosing a
project for proposal from xref:ideas.adoc[ideas list]. While it is
project for proposal from xref:gsoc/2018/ideas.adoc[ideas list]. While it is
possible to propose your own project, it is often more successful for
you to select one that is already proposed by a mentor.

2
modules/ROOT/pages/gsoc/2018/ideas.adoc
View file

@ -1,6 +1,6 @@
= Google Summer of Code 2018 Mentors and Ideas
NOTE: Fedora has been accepted as a mentoring organization! Please make sure you carefully read through the link:index.html[general information] and xref:application.adoc[application process] pages before applying.
NOTE: Fedora has been accepted as a mentoring organization! Please make sure you carefully read through the link:index.html[general information] and xref:gsoc/2018/application.adoc[application process] pages before applying.
If you are a student looking forward to participating in
link:index.html[Google Summer of Code with Fedora], please feel free to

10
modules/ROOT/pages/gsoc/2018/index.adoc
View file

@ -23,8 +23,8 @@ Fedora has been accepted as a mentoring organization. Student
applications open on 12 March.
////
Today you should read through the xref:ideas.adoc[ideas] and think about
our xref:application.adoc[application process.]
Today you should read through the xref:gsoc/2018/ideas.adoc[ideas] and think about
our xref:gsoc/2018/application.adoc[application process.]
[[student-information]]
== Student Information
@ -48,14 +48,14 @@ NOTE: Student applications **are not yet open**.
////
* If you're interested in working on a mentor-submitted idea, read
the xref:ideas.adoc[ideas page] and about the project and the related
the xref:gsoc/2018/ideas.adoc[ideas page] and about the project and the related
technology. There is no need to contact the mentor unless you have a
specific question about the project. Don't send an "I'm interested" email.
* If you're interested in proposing your own project start looking
around the Fedora Project for a mentor and send your idea to the mailing
list or post it on the wiki. A list of potential mentors is also on the
xref:ideas.adoc[ideas page].
xref:gsoc/2018/ideas.adoc[ideas page].
////
@ -138,7 +138,7 @@ Your responsibilities include:
=== Student Application
Please read and follow the
xref:application.adoc[student application process].
xref:gsoc/2018/application.adoc[student application process].
[[mentor-information]]
== Mentor Information

2
modules/ROOT/pages/outreachy/2020-ideas.adoc
View file

@ -5,7 +5,7 @@ round running from May to August 2020 and we have already selected our interns
for this season.
If you are a student looking to participate in
xref:outreachy/2020/index.adoc[Outreachy], please feel free to
xref:outreachy/2020.adoc[Outreachy], please feel free to
browse this idea list. There may be additional ideas added during the
application period.

2
modules/ROOT/pages/outreachy/2021-ideas.adoc
View file

@ -5,7 +5,7 @@ round running from May to August 2021 and we are yet to the participants for
this season.
If you are a student looking to participate in
xref:outreachy/2021/index.adoc[Outreachy], please feel free to
xref:outreachy/2021.adoc[Outreachy], please feel free to
browse this idea list. There may be additional ideas added during the
application period.