Skip to content

Commit 2813e69

Browse files
committed
Update other links to specific sections
Redirects break section anchors, so put target links directly there.
1 parent 80e2f61 commit 2813e69

File tree

11 files changed

+20
-20
lines changed

11 files changed

+20
-20
lines changed

_data/downloads-page.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,5 +40,5 @@
4040
- column: Location
4141
- column: URL
4242
links:
43-
- url: /downloads/mirrors/#instructions-for-mirror-operators
43+
- url: https://doc.qubes-os.org/en/latest/user/downloading-installing-upgrading/download-mirrors.html#instructions-for-mirror-operators
4444
text: How to contribute a download mirror

_data/hcl.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
- url: '#hardware-motherboards'
1111
text: Motherboards
1212
id: 3
13-
- url: /doc/how-to-use-the-hcl/#generating-and-submitting-new-reports
13+
- url: https://doc.qubes-os.org/en/latest/user/hardware/how-to-use-the-hcl.html#generating-and-submitting-new-reports
1414
text: Add your device
1515
id: 4
1616

@@ -20,7 +20,7 @@
2020
- url: /doc/how-to-use-the-hcl/
2121
text: What is the hardware compatibility list (HCL)?
2222
id: 1
23-
- url: /doc/how-to-use-the-hcl/#generating-and-submitting-new-reports
23+
- url: https://doc.qubes-os.org/en/latest/user/hardware/how-to-use-the-hcl.html#generating-and-submitting-new-reports
2424
text: How do I submit a report?
2525
id: 2
2626
- url: /doc/system-requirements/

_doc/developer/general/documentation-style-guide.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ This rule is important because using absolute URLs for internal website links br
4646

4747
### Image linking
4848

49-
See [how to add images](/doc/how-to-edit-the-documentation/#how-to-add-images) for the required syntax. This will make the image a hyperlink to the image file, allowing the reader to click on the image in order to view the full image by itself. This is important. Following best practices, our website has a responsive design, which allows the website to render appropriately across all screen sizes. When viewing this page on a smaller screen, such as on a mobile device, the image will automatically shrink down to fit the screen. If visitors cannot click on the image to view it in full size, then, depending on their device, they may have no way see the details in the image clearly.
49+
See [how to add images](https://doc.qubes-os.org/en/latest/developer/general/how-to-edit-the-documentation.html#how-to-add-images) for the required syntax. This will make the image a hyperlink to the image file, allowing the reader to click on the image in order to view the full image by itself. This is important. Following best practices, our website has a responsive design, which allows the website to render appropriately across all screen sizes. When viewing this page on a smaller screen, such as on a mobile device, the image will automatically shrink down to fit the screen. If visitors cannot click on the image to view it in full size, then, depending on their device, they may have no way see the details in the image clearly.
5050

5151
In addition, make sure to link only to images in the [qubes-attachment](https://github.com/QubesOS/qubes-attachment) repository. Do not attempt to link to images hosted on other websites.
5252

@@ -242,7 +242,7 @@ We have observed that many novices make the mistake of typing the surrounding an
242242

243243
### Capitalization of "qube"
244244

245-
We introduced the term ["qube"](/doc/glossary/#qube) as a user-friendly alternative to the term ["virtual machine" ("VM")](/doc/glossary/#vm) in the context of Qubes OS. Nonetheless, "qube" is a common noun like the words "compartment" and "container." Therefore, in English, "qube" follows the standard capitalization rules for common nouns. For example, "I have three qubes" is correct, while "I have three Qubes" is incorrect. Like other common nouns, "qube" should still be capitalized at the beginnings of sentences, the beginnings of sentence-case headings, and in title-case headings. Note, however, that starting a sentence with the plural of "qube" (e.g., "Qubes can be shut down...") can be ambiguous, since it may not be clear whether the referent is a plurality of qubes, [Qubes OS](/doc/glossary/#qubes-os), or even the Qubes OS Project itself. Hence, it is generally a good idea to rephrase such sentences in order to avoid this ambiguity.
245+
We introduced the term ["qube"](https://doc.qubes-os.org/en/latest/user/reference/glossary.html#qube) as a user-friendly alternative to the term ["virtual machine" ("VM")](https://qubes-doc-rst.readthedocs.io/en/latest/user/reference/glossary.html#vm) in the context of Qubes OS. Nonetheless, "qube" is a common noun like the words "compartment" and "container." Therefore, in English, "qube" follows the standard capitalization rules for common nouns. For example, "I have three qubes" is correct, while "I have three Qubes" is incorrect. Like other common nouns, "qube" should still be capitalized at the beginnings of sentences, the beginnings of sentence-case headings, and in title-case headings. Note, however, that starting a sentence with the plural of "qube" (e.g., "Qubes can be shut down...") can be ambiguous, since it may not be clear whether the referent is a plurality of qubes, [Qubes OS](https://qubes-doc-rst.readthedocs.io/en/latest/user/reference/glossary.html#qubes-os), or even the Qubes OS Project itself. Hence, it is generally a good idea to rephrase such sentences in order to avoid this ambiguity.
246246

247247
Many people feel a strong temptation to capitalize the word "qube" all the time, like a proper noun, perhaps because it's a new and unfamiliar term that's closely associated with a particular piece of software (namely, Qubes OS). However, these factors are not relevant to the capitalization rules of English. In fact, it's not unusual for new common nouns to be introduced into English, especially in the context of technology. For example, "blockchain" is a relatively recent technical term that's a common noun. Why is it a common noun rather than a proper noun? Because proper nouns refer to *particular* people, places, things, and ideas. There are many different blockchains. However, even when there was just one, the word still denoted a collection of things rather than a particular thing. It happened to be the case that there was only one member in that collection at the time. For example, if there happened to be only one tree in the world, that wouldn't change the way we capitalize sentences like, "John sat under a tree." Intuitively, it makes sense that the addition and removal of objects from the world shouldn't cause published books to become orthographicallly incorrect while sitting on their shelves.
248248

@@ -262,11 +262,11 @@ Duplicating documentation is almost always a bad idea. There are many reasons fo
262262

263263
### Core vs. external documentation
264264

265-
Core documentation resides in the [Qubes OS Project's official repositories](https://github.com/QubesOS/), mainly in [qubes-doc](https://github.com/QubesOS/qubes-doc). External documentation can be anywhere else (such as forums, community websites, and blogs), but there is an especially large collection in the [Qubes Forum](https://forum.qubes-os.org/docs). External documentation should not be submitted to [qubes-doc](https://github.com/QubesOS/qubes-doc). If you've written a piece of documentation that is not appropriate for [qubes-doc](https://github.com/QubesOS/qubes-doc), we encourage you to submit it to the [Qubes Forum](https://forum.qubes-os.org/docs) instead. However, *linking* to external documentation from [qubes-doc](https://github.com/QubesOS/qubes-doc) is perfectly fine. Indeed, the maintainers of the [Qubes Forum](https://forum.qubes-os.org/) should regularly submit PRs against the documentation index (see [How to edit the documentation index](/doc/how-to-edit-the-documentation/#how-to-edit-the-documentation-index)) to add and update Qubes Forum links in the ["External documentation"](/doc/#external-documentation) section of the documentation table of contents.
265+
Core documentation resides in the [Qubes OS Project's official repositories](https://github.com/QubesOS/), mainly in [qubes-doc](https://github.com/QubesOS/qubes-doc). External documentation can be anywhere else (such as forums, community websites, and blogs), but there is an especially large collection in the [Qubes Forum](https://forum.qubes-os.org/docs). External documentation should not be submitted to [qubes-doc](https://github.com/QubesOS/qubes-doc). If you've written a piece of documentation that is not appropriate for [qubes-doc](https://github.com/QubesOS/qubes-doc), we encourage you to submit it to the [Qubes Forum](https://forum.qubes-os.org/docs) instead. However, *linking* to external documentation from [qubes-doc](https://github.com/QubesOS/qubes-doc) is perfectly fine. Indeed, the maintainers of the [Qubes Forum](https://forum.qubes-os.org/) should regularly submit PRs against the documentation index (see [How to edit the documentation index](https://doc.qubes-os.org/en/latest/developer/general/how-to-edit-the-documentation.html#how-to-edit-the-documentation-index)) to add and update Qubes Forum links in the ["External documentation"](https://qubes-doc-rst.readthedocs.io/en/latest/index.html#external-documentation) section of the documentation table of contents.
266266

267267
The main difference between **core** (or **official**) and **external** (or **community** or **unofficial**) documentation is whether it documents software that is officially written and maintained by the Qubes OS Project. The purpose of this distinction is to keep the core docs maintainable and high-quality by limiting them to the software output by the Qubes OS Project. In other words, we take responsibility for documenting all of the software we put out into the world, but it doesn't make sense for us to take on the responsibility of documenting or maintaining documentation for anything else. For example, Qubes OS may use a popular Linux distribution for an official [TemplateVM](/doc/templates/). However, it would not make sense for a comparatively small project like ours, with modest funding and a lean workforce, to attempt to document software belonging to a large, richly-funded project with an army of paid and volunteer contributors, especially when they probably already have documentation of their own. This is particularly true when it comes to Linux in general. Although many users who are new to Qubes are also new to Linux, it makes absolutely no sense for our comparatively tiny project to try to document Linux in general when there is already a plethora of documentation out there.
268268

269-
Many contributors do not realize that there is a significant amount of work involved in *maintaining* documentation after it has been written. They may wish to write documentation and submit it to the core docs, but they see only their own writing process and fail to consider that it will have to be kept up-to-date and consistent with the rest of the docs for years afterward. Submissions to the core docs also have to [undergo a review process](/doc/how-to-edit-the-documentation/#security) to ensure accuracy before being merged, which takes up valuable time from the team. We aim to maintain high quality standards for the core docs (style and mechanics, formatting), which also takes up a lot of time. If the documentation involves anything external to the Qubes OS Project (such as a website, platform, program, protocol, framework, practice, or even a reference to a version number), the documentation is likely to become outdated when that external thing changes. It's also important to periodically review and update this documentation, especially when a new Qubes release comes out. Periodically, there may be technical or policy changes that affect all the core documentation. The more documentation there is relative to maintainers, the harder all of this will be. Since there are many more people who are willing to write documentation than to maintain it, these individually small incremental additions amount to a significant maintenance burden for the project.
269+
Many contributors do not realize that there is a significant amount of work involved in *maintaining* documentation after it has been written. They may wish to write documentation and submit it to the core docs, but they see only their own writing process and fail to consider that it will have to be kept up-to-date and consistent with the rest of the docs for years afterward. Submissions to the core docs also have to [undergo a review process](https://doc.qubes-os.org/en/latest/developer/general/how-to-edit-the-documentation.html#security) to ensure accuracy before being merged, which takes up valuable time from the team. We aim to maintain high quality standards for the core docs (style and mechanics, formatting), which also takes up a lot of time. If the documentation involves anything external to the Qubes OS Project (such as a website, platform, program, protocol, framework, practice, or even a reference to a version number), the documentation is likely to become outdated when that external thing changes. It's also important to periodically review and update this documentation, especially when a new Qubes release comes out. Periodically, there may be technical or policy changes that affect all the core documentation. The more documentation there is relative to maintainers, the harder all of this will be. Since there are many more people who are willing to write documentation than to maintain it, these individually small incremental additions amount to a significant maintenance burden for the project.
270270

271271
On the positive side, we consider the existence of community documentation to be a sign of a healthy ecosystem, and this is quite common in the software world. The community is better positioned to write and maintain documentation that applies, combines, and simplifies the official documentation, e.g., tutorials that explain how to install and use various programs in Qubes, how to create custom VM setups, and introductory tutorials that teach basic Linux concepts and commands in the context of Qubes. In addition, just because the Qubes OS Project has officially written and maintains some flexible framework, such as `qrexec`, it does not make sense to include every tutorial that says "here's how to do something cool with `qrexec`" in the core docs. Such tutorials generally also belong in the community documentation.
272272

@@ -352,4 +352,4 @@ For further discussion about release-specific documentation in Qubes, see [here]
352352

353353
## Git conventions
354354

355-
Please follow our [Git commit message guidelines](/doc/coding-style/#commit-message-guidelines).
355+
Please follow our [Git commit message guidelines](https://doc.qubes-os.org/en/latest/developer/code/coding-style.html#commit-message-guidelines).

_doc/developer/general/how-to-edit-the-documentation.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -159,12 +159,12 @@ especially when your changes affect formatting, images, tables, styling, etc.
159159

160160
## Security
161161

162-
*Also see: [Should I trust this website?](/faq/#should-i-trust-this-website)*
162+
*Also see: [Should I trust this website?](https://doc.qubes-os.org/en/latest/introduction/faq.html#should-i-trust-this-website)*
163163

164164
All pull requests (PRs) against
165165
[qubes-doc](https://github.com/QubesOS/qubes-doc) must pass review prior to be
166166
merged, except in the case of [external
167-
documentation](/doc/#external-documentation) (see
167+
documentation](https://doc.qubes-os.org/en/latest/index.html#external-documentation) (see
168168
[#4693](https://github.com/QubesOS/qubes-issues/issues/4693)). This process is
169169
designed to ensure that contributed text is accurate and non-malicious. This
170170
process is a best effort that should provide a reasonable degree of assurance,

_doc/developer/system/system-doc.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ redirect_from:
77
- /doc/SystemDoc/
88
- /wiki/SystemDoc/
99
redirect_to:
10-
- /doc/#developer-documentation
10+
- https://doc.qubes-os.org/en/latest/index.html#developer-documentation
1111
ref: 62
1212
title: System documentation
13-
---
13+
---

_includes/variables.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@
6969
{% endif %}
7070
{% endif %}
7171
<!-- Doc link -->
72-
{% assign doc_link = lang | append: "/doc/" %}
72+
{% assign doc_link = "https://doc.qubes-os.org/" | append: page.lang | append: "/latest/index.html" %}
7373
<!-- Team link -->
7474
{% assign team_link = lang | append: "/team/" %}
7575
<!-- News by category link -->

pages/canary.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ title: Qubes canaries
1010
---
1111

1212
A **Qubes canary** is a security announcement periodically issued by the [Qubes
13-
security team](/security/#qubes-security-team) through the [Qubes security
13+
security team](https://doc.qubes-os.org/en/latest/project-security/security.html#qubes-security-team) through the [Qubes security
1414
pack](/security/pack/) consisting of several statements to the effect that the
1515
signers of the canary have not been compromised. The idea is that, as long as
1616
signed canaries including such statements continue to be published, all is

pages/donate.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -148,20 +148,20 @@ However, if you or your organization has relevant knowledge, experience, leads,
148148
### How do I verify your Bitcoin address?
149149

150150
The donation address can be verified via the [Qubes Security Pack](/security/pack/), specifically in the [fund directory](https://github.com/QubesOS/qubes-secpack/tree/master/fund).
151-
We provide [detailed instructions for verifying the digital signatures](/security/pack/#how-to-obtain-and-authenticate).
151+
We provide [detailed instructions for verifying the digital signatures](https://doc.qubes-os.org/en/latest/project-security/security-pack.html#how-to-obtain-and-authenticate).
152152

153153
The Qubes Project maintains a [decentralized Bitcoin fund using a multi-signature wallet](/news/2016/07/13/qubes-distributed-fund/).
154154
This means that no single person is capable of spending these funds.
155155

156156
### How do I verify your Ethereum address?
157157

158158
The donation address can be verified via the [Qubes Security Pack](/security/pack/), specifically in the [fund directory](https://github.com/QubesOS/qubes-secpack/tree/master/fund).
159-
We provide [detailed instructions for verifying the digital signatures](/security/pack/#how-to-obtain-and-authenticate).
159+
We provide [detailed instructions for verifying the digital signatures](https://doc.qubes-os.org/en/latest/project-security/security-pack.html#how-to-obtain-and-authenticate).
160160

161161
### How do I verify your Monero address?
162162

163163
The donation address can be verified via the [Qubes Security Pack](/security/pack/), specifically in the [fund directory](https://github.com/QubesOS/qubes-secpack/tree/master/fund).
164-
We provide [detailed instructions for verifying the digital signatures](/security/pack/#how-to-obtain-and-authenticate).
164+
We provide [detailed instructions for verifying the digital signatures](https://doc.qubes-os.org/en/latest/project-security/security-pack.html#how-to-obtain-and-authenticate).
165165

166166
### Is Qubes merchandise available?
167167

pages/home.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -235,7 +235,7 @@ <h2 class="text-center outer-heading"><i class="fa fa-users"></i> Join the Commu
235235
</div>
236236
<div class="white-box more-bottom">
237237
<div class="row">
238-
<p>Have questions or need a hand? As a free and open-source project, our valued community of users and contributors from around the world are in the best position to help. Before diving in, we encourage you to read about <a href="/support/#staying-safe">staying safe</a>, our <a href="/support/#discussion-guidelines">discussion guidelines</a>, and our <a href="/code-of-conduct/">code of conduct</a> to help keep things positive and on-track. We welcome newcomers and returning users wanting to discuss Qubes and <a href="/doc/contributing/">seeking to contribute</a>.
238+
<p>Have questions or need a hand? As a free and open-source project, our valued community of users and contributors from around the world are in the best position to help. Before diving in, we encourage you to read about <a href="https://doc.qubes-os.org/en/latest/introduction/support.html#staying-safe">staying safe</a>, our <a href="https://qubes-doc-rst.readthedocs.io/en/latest/introduction/support.html#discussion-guidelines">discussion guidelines</a>, and our <a href="/code-of-conduct/">code of conduct</a> to help keep things positive and on-track. We welcome newcomers and returning users wanting to discuss Qubes and <a href="/doc/contributing/">seeking to contribute</a>.
239239
</div>
240240
<div class="clearfix"></div>
241241
<div class="row more-bottom">

0 commit comments

Comments
 (0)