Commit Graph

249 Commits

Author SHA1 Message Date
Andrew David Wong 308fadf650
Improve language and links 2021-06-21 18:50:25 -07:00
Andrew David Wong a015f60087
Fix links 2021-06-21 18:39:21 -07:00
Andrew David Wong bf7c44536b
Update mailing list info
- Further emphasize that Google accounts are not required
- Prioritize traditional mail archive links ahead of Google Groups
2021-06-21 03:21:22 -07:00
Andrew David Wong b02f6ade06
Fix typo 2021-06-21 03:11:21 -07:00
Andrew David Wong 1ecad8cd03
Update text 2021-06-21 03:01:17 -07:00
Andrew David Wong 0701f196c8
Update "Help, Support, Mailing Lists, and Forum"
- Revamp intro to make it (hopefully) more user-friendly
- Generalize last section into "Unofficial venues"
- Warn that we do not monitor or moderate unofficial venues
- Warn more explicitly about possible Qubes team impostors
- Miscellaneous updates and improvements
2021-06-21 02:55:53 -07:00
Andrew David Wong 0c3c2aa82d
Update "Issue Tracking"
- Improve section organization
- Improve new issue instructions
- Add section on "projects"
- Convert final section into "How issues get closed"
- Add section on backports (closes QubesOS/qubes-issues#6655)
2021-06-21 01:43:38 -07:00
Andrew David Wong 527a2eb339
Update links 2021-06-21 00:38:18 -07:00
Andrew David Wong f860726c93
Rename file to match new title 2021-06-21 00:31:01 -07:00
Andrew David Wong 60a894bded
Revamp "Reporting Bugs and Other Issues"
- Rename to "Issue Tracking" (file rename in separate commit to preserve
  history)
- Break the "Important" section up into multiple shorter sections in an
  attempt to discourage people from skipping over it
- Add "How to open a new issue" section
- Add "Labels and milestones" section
- Update heading syntax
2021-06-21 00:28:42 -07:00
Andrew David Wong dec4c71a79
Update button to match page title 2021-06-20 22:29:11 -07:00
Andrew David Wong b8ffe76d54
Update and fix links 2021-06-19 21:47:40 -07:00
Andrew David Wong b88fe1d32d
Rename *.html files to *.md
This eases the doc maintenance burden by allowing bulk operations on
*.md files without missing intended files (whereas attempting to perform
such operations on *all* files can be dangerous due to hidden git files,
for example). Since HTMl can validly be embedded in Markdown files, this
doesn't affect the way the pages are rendered.
2021-06-19 21:35:44 -07:00
Andrew David Wong 3676c18bdb
Move experts.md to main website repo
This file contains no content anymore, and it's not documentation.
2021-06-19 20:42:03 -07:00
Andrew David Wong 2dbc8865e1
Use doc layout instead of sidebar layout
There appears to be no strong reason that these pages are using a
different layout, and having this separate layout significantly
increases the ongoing doc maintenance burden.
2021-06-19 20:39:34 -07:00
Andrew David Wong ea0a14fb7a
Update OS names 2021-06-19 02:24:52 -07:00
Andrew David Wong 325abc8cc3
Fix typo 2021-06-18 07:33:55 -07:00
Andrew David Wong 679c54e056
Update privacy.md 2021-06-18 07:31:09 -07:00
Andrew David Wong d3e74d5c0b
Update retention period 2021-06-18 06:26:23 -07:00
Andrew David Wong 07c130df00
Wrap text and miscellaneous cleanup 2021-06-18 06:25:06 -07:00
Andrew David Wong e451f92cde
Update attachment paths 2021-06-18 05:46:02 -07:00
Andrew David Wong 60bd80ad25
Revert "Update attachment paths"
This reverts commit e5a21f7488.
2021-06-18 05:39:47 -07:00
Andrew David Wong e5a21f7488
Update attachment paths 2021-06-18 05:02:02 -07:00
Andrew David Wong e26e40cdc5
Replace "TemplateVM" with "template"; fix links
QubesOS/qubes-issues#1015
2021-06-18 03:37:30 -07:00
Andrew David Wong ce031173f0
Fix links and update terms
QubesOS/qubes-issues#1015
2021-06-18 03:12:22 -07:00
Andrew David Wong 88a4e0a4b5
Fix links 2021-06-18 02:59:26 -07:00
Andrew David Wong be1d9649bd
Merge branch 'patch-1' of https://github.com/SvenSemmler/qubes-doc into SvenSemmler-patch-1 2021-06-17 22:55:51 -07:00
Andrew David Wong a31ee53024
Minor improvements 2021-06-17 22:55:06 -07:00
Andrew David Wong 07bf7884fb
Improve language and accuracy 2021-06-17 22:53:47 -07:00
Sven Semmler e294b0eb4c
Where to install software
Based on https://qubes-os.discourse.group/t/software-will-install-then-doesnt-save-and-cant-be-found-this-is-not-a-disposable-vm-plenty-of-space/4634/1 ... seen this a lot lately and thought it's time for an FAQ entry.
2021-06-17 18:16:47 -05:00
Andrew David Wong 19c5334ff8
Fix typo 2021-06-17 11:20:30 -07:00
Andrew David Wong 7d3fd4fa26
Create general Privacy Policy; add mirror note
Based on @unman's proposal:
c52aaa6821

Original context:
https://qubes-os.discourse.group/t/qubes-website-privacy-policy/2235/
2021-06-17 11:06:21 -07:00
Andrew David Wong 08eb959f6f
Add FAQ entry on data use
https://qubes-os.discourse.group/t/qubes-website-privacy-policy/2235/
2021-06-17 08:04:14 -07:00
Andrew David Wong 2d0cbc0991
Add FAQ entry on data retention
https://qubes-os.discourse.group/t/qubes-website-privacy-policy/2235/
2021-06-17 08:02:21 -07:00
Andrew David Wong 76150ac9d3
Fix links 2021-06-17 07:01:53 -07:00
Andrew David Wong 6d81f95cc2
Update and reorganize documentation
- Convert "Common Tasks" to "How-to Guides"
  (QubesOS/qubes-issues#6694)
- Make title capitalization consistent across docs
- Fix leftover h1 headings
- Reorganize various pages and topics
- Update permalinks to better match titles
- Create redirects for changed permalinks
- Miscellaneous cleanup

QubesOS/qubes-issues#6701
2021-06-17 05:16:22 -07:00
Andrew David Wong 12408884dd
Clean up YAML titles and create redirect stubs
QubesOS/qubes-issues#6701
2021-06-17 02:40:43 -07:00
Andrew David Wong 2c473241a8
Revert "Remove all instances of `permalink:` in YAML frontmatter"
This reverts commit c815e4c54c.

https://github.com/QubesOS/qubes-issues/issues/6701#issuecomment-862822827
2021-06-16 19:56:25 -07:00
Andrew David Wong 8f2efb70cb
Remove redundant h1 heading
QubesOS/qubes-issues#6701
2021-06-16 03:10:21 -07:00
Andrew David Wong a4cbb51092
Remove vestigial '====' heading syntax
https://github.com/QubesOS/qubes-issues/issues/6701#issuecomment-862060759
2021-06-15 23:53:27 -07:00
Andrew David Wong f822b70435
Remove redundant titles
First pass for all titles still using the old '=====' syntax

https://github.com/QubesOS/qubes-issues/issues/6701#issuecomment-862060759
2021-06-15 23:48:48 -07:00
Andrew David Wong 0c95b3ae4d
Revert "Remove instances of `title:` from YAML headers"
This reverts commit 24e6a8a616.

https://github.com/QubesOS/qubes-issues/issues/6701#issuecomment-862060759
2021-06-15 23:19:45 -07:00
Andrew David Wong c815e4c54c
Remove all instances of `permalink:` in YAML frontmatter
Converts existing permalink paths into redirect_from entries.

QubesOS/qubes-issues#6701
2021-06-15 22:33:51 -07:00
Andrew David Wong 24e6a8a616
Remove instances of `title:` from YAML headers
QubesOS/qubes-issues#6701
2021-06-15 22:16:59 -07:00
Andrew David Wong e1f929b0ca
Move issue template guideline up and update wording 2021-05-27 21:33:04 -07:00
Marek Marczykowski-Górecki 759b46fa04
Migrate off freenode 2021-05-26 13:50:01 +02:00
Andrew David Wong ada8749758
Mention discussion and forum 2021-05-24 02:46:49 -07:00
Andrew David Wong 255f286430
Fix typo 2021-05-23 22:23:18 -07:00
Andrew David Wong cb68c39f65
Expound on issue tracking guidelines 2021-05-23 21:57:50 -07:00
herypt 8a8178db0d
Remove Flash documentation 2021-05-14 14:08:12 +02:00
deeplow 0d99bbbe31
Update support.md 2021-05-09 10:50:39 +00:00
deeplow 9bd9686a0c
add link to using forum via email 2021-05-09 10:48:59 +00:00
deeplow c95744e860
add link to instructions on forum via email 2021-05-03 17:29:14 +00:00
Andrew David Wong 3c8c1464e2
Direct users to check docs before asking for help 2021-05-01 03:25:55 -07:00
Andrew David Wong 1dca07f29c
Make forum description more accurate; integrate link 2021-04-27 19:58:54 -07:00
Tobias Killer bcbeae7463
Resolve open issues mentioned on Transifex 2021-04-17 11:03:50 +02:00
Tobias Killer 098f5b418c
Resolve open issues mentioned on Transifex 2021-04-17 10:57:16 +02:00
Tobias Killer 6b33020140
Resolve open issues mentioned on Transifex 2021-04-17 10:45:27 +02:00
Tobias Killer 2ae338948a
Repair link 2021-04-11 09:23:35 +02:00
Tobias Killer 5047127350
Merge branch 'master' into md-refactoring-links 2021-04-11 00:44:42 +02:00
Tobias Killer b6cb04c297
Refactor links in order to obey the new convention rule 2021-04-11 00:09:05 +02:00
Andrew David Wong 84c1cb36ea
Clarify that the issue tracker is not a discussion forum 2021-04-10 08:03:09 -07:00
E. Cleopatra fafc9cde17
Edit button label 2021-04-02 02:51:37 +01:00
Marek Marczykowski-Górecki 965d495c2c
Remove broken redirect
There is no way to redirect _from_ a #href link. The one without # is
already included.
2021-03-30 13:17:15 +02:00
Maya 820af56761
Add lang + ref tags to frontmatter
Those are fields used by the language switcher to correlate pages across
different languages, even if they have different names/paths/titles.
They are generated with the prepare_for_translation.py script.
2021-03-14 16:18:11 +01:00
Maya 1a92224f8b
Remove content from pages dynamically filled in by a relevant layout
In fact, right now those pages content is duplicated - once included
here and once inserted by the doc-content (or hcl) layout.
2021-03-14 16:18:11 +01:00
Maya 8f8a8e50ea
Normalize frontmatter
- sort keys
- remove permalink from redirects
2021-03-14 16:18:10 +01:00
Maya 67a92614aa
Markdown formatting fixes
- mark all code blocks with ```
- unify empty lines between sections
- adjust list syntax (no space before dash)
- adjust headers to use Atx-style syntax
- remove trailing spaces
2021-03-14 16:18:10 +01:00
Andrew David Wong 5310611d88
Fix broken link (#1114) 2021-02-26 13:12:30 -08:00
HackerNCoder 5701f5b733
Downgrade images to 4.0 2021-02-16 02:44:31 +01:00
Andrew David Wong 39b6f3b871
Merge branch 'hardware-troubleshooting' of https://github.com/PROTechThor/qubes-doc into PROTechThor-hardware-troubleshooting 2021-02-15 04:29:42 -08:00
Andrew David Wong 1ced4e11d9
Merge branch 'faq-opengl' of https://github.com/AlxHnr/qubes-doc into AlxHnr-faq-opengl 2021-01-05 16:03:00 -08:00
Andrew David Wong fafa91bcec
Add section on moderation
Discussed in:
https://qubes-os.discourse.group/t/deletion-policy/2099/
2021-01-03 08:27:39 -08:00
Andrew David Wong 401447bcde
Encourage users to stay informed of QSBs
- Add "Next steps: Security" section to installation guide
 - Add social media section to support page, as a way to receive news
   updates

Discussed in:
 - QubesOS/qubes-issues#6299
 - https://qubes-os.discourse.group/t/safety-when-forced-not-to-use-updater/2085
2021-01-03 08:08:37 -08:00
Andrew David Wong b489bfc6a7
Update broken Transifex link
QubesOS/qubes-issues#3548
2020-12-21 19:18:08 -08:00
Robin Schneider ec70076361
Use HTTPS everywhere (mechanical edit using util from https-everywhere)
Ref: https://github.com/EFForg/https-everywhere/tree/master/utils/rewriter

```Shell
~/src/EFForg/https-everywhere/utils/rewriter/rewriter.js .
```
2020-12-19 19:57:07 +01:00
Andrew David Wong 2fa0fad4bc
Minor edit 2020-12-16 17:10:05 -08:00
Alexander Heinrich b835c340b3 Reword section concerning GPU virtualization 2020-12-16 11:36:35 +01:00
Andrew David Wong 0504144c81
Update text to accord with doc guidelines (#1102) 2020-12-08 16:39:37 -08:00
HackerNCoder 464ffa5c01
Change screenshots text to refelct 4.0/.1 and remove reused image 2020-12-08 14:53:25 +01:00
Andrew David Wong d201a09b9a
Update links to Qubes-Community version
https://github.com/QubesOS/qubes-issues/issues/4693
2020-12-07 22:31:41 -08:00
Andrew David Wong 30e7112f4a
Convert absolute to relative links
Absolute links break automatic onion redirection:
https://groups.google.com/g/qubes-users/c/NJdzP27wvmM/
2020-12-07 17:04:29 -08:00
Marek Marczykowski-Górecki 1d4d6b233a
typo fix in #generating-and-submitting-new-reports 2020-11-27 14:27:31 +01:00
Andrew David Wong 7ea95a1b80
Suggest linking to HCL report in support request
QubesOS/qubes-issues#6231
2020-11-25 05:10:50 -08:00
Andrew David Wong 5ab54a9dea
Suggest linking to HCL report in issue
QubesOS/qubes-issues#6231
2020-11-25 05:07:33 -08:00
Andrew David Wong 0a27688e51
Merge branch 'update-troubleshooting' of https://github.com/PROTechThor/qubes-doc into PROTechThor-update-troubleshooting 2020-11-25 04:20:18 -08:00
Andrew David Wong 233e45ba71
Update entry on VT-x/AMD-V importance 2020-11-21 08:02:28 -08:00
Andrew David Wong 48a2a2b037
Update FAQ entries with respect to system requirements
- Remove outdated information
 - Generalize references to specific versions
 - Fix grammar and orthography
2020-11-21 06:58:21 -08:00
PROTechThor 8e06262d7a Add Update Troublshooting, edit VM TS 2020-11-21 00:20:47 +01:00
PROTechThor ce3618cfc0 Add Hardware Troubleshooting 2020-11-14 18:30:58 +01:00
Andrew David Wong 5584721fbb
Merge branch 'qubes-is-slow' of https://github.com/PROTechThor/qubes-doc into PROTechThor-qubes-is-slow 2020-10-28 23:33:27 -07:00
Enjeck Cleopatra f8b6b5fe97 Add new FAQ 2020-10-28 05:34:48 +01:00
Andrew David Wong 0e5a97785c
Add information about doc review security 2020-10-27 19:23:57 -07:00
Andrew David Wong 9245d9f890
Merge branch 'upgradeImagesTo4.1' of https://github.com/hackerncoder/qubes-doc into hackerncoder-upgradeImagesTo4.1 2020-10-27 18:19:33 -07:00
Andrew David Wong 6b55542c67
Merge branch 'usb-troubleshooting' of https://github.com/PROTechThor/qubes-doc into PROTechThor-usb-troubleshooting 2020-10-27 18:03:50 -07:00
Andrew David Wong dde36d4515
Remove outdated KDE screenshots
QubesOS/qubes-issues#5838
2020-10-27 18:00:40 -07:00
hackerncoder 09602cd961
Fix me not being able to use vim (4.1 > ')') 2020-10-26 21:39:43 +01:00
hackerncoder 9bafa3d27d
Remove -2 from qubes-manager. Add -1 to convertPDF. Change sysnet-network-prompt to r4.1-..-sysnet.. 2020-10-26 21:27:53 +01:00
PROTechThor e9d2c7a655 Fix links 2020-10-26 04:22:27 +01:00
hackerncoder ef890d4253
change applicable images to 4.1 screenshots 2020-10-25 17:04:17 +01:00
Enjeck Cleopatra 773aa66af9
Add # to link 2020-10-19 14:28:55 +01:00
Enjeck Cleopatra 4fab5d1c59
Fix spelling error 2020-10-18 12:22:23 +01:00
PROTechThor f93cc80f36 Add USB Troubleshooting 2020-10-18 11:44:45 +01:00
Andrew David Wong e70e55984e
Fix link 2020-10-12 21:29:56 -05:00
Andrew David Wong 4994948519
Update introduction
- Provide info about orgs and experts that rely on, recommend, and/or
   support Qubes.
 - Add paragraph about Qubes' user-security-first and FOSS philosophy.
 - Format last section and image similar to the preceding two.
2020-09-25 14:41:03 -05:00
Andrew David Wong 3110a406b6
Update links 2020-09-13 08:19:29 -05:00
Andrew David Wong cfb2917286
Update image filename
QubesOS/qubes-issues#6034
2020-09-13 06:17:20 -05:00
Andrew David Wong c7c4063654
Explain no match when installing TemplateVM
https://github.com/QubesOS/qubes-issues/issues/4858
2020-09-07 00:09:47 -05:00
Andrew David Wong 899c839885
Update privacy entries
Thanks to forum user QubicRoot for feedback on these entries.
2020-09-05 20:42:57 -05:00
Andrew David Wong 0b009953de
Replace icons 2020-09-03 18:12:35 -05:00
Andrew David Wong 190cab5172
Add privacy FAQs 2020-09-03 17:10:20 -05:00
Andrew David Wong 04cfdbac23
Minor FAQ update 2020-09-01 22:38:02 -05:00
Andrew David Wong d3d316abaa
Improve intro page formatting 2020-08-30 01:30:10 -05:00
Andrew David Wong 9f5e0863e5
Improve userbase statistics image handling
- Use classes instead of in-line styling
 - Link to full-size image
2020-08-29 19:41:40 -05:00
Andrew David Wong a445be4503
Change intro page file extension to .html 2020-08-29 17:17:04 -05:00
Andrew David Wong 639a34e9ce
Update intro page
- Clean up source
 - Use HTML consistently throughout
 - Fix images
2020-08-29 17:16:38 -05:00
Andrew David Wong 5746954d5d
Improve writing; wrap lines 2020-08-25 15:08:20 -05:00
deeplow 22d05b9d04
mention forum in "report issues in the right place" 2020-08-25 07:04:44 +00:00
Andrew David Wong b894253c40
Light editing 2020-08-24 09:18:55 -05:00
Andrew David Wong 76cba6ff5f
Minor 2020-08-24 08:32:57 -05:00
Andrew David Wong c542d52b10
Improve intro
- Add content
 - Fix grammar and orthography
 - Improve formatting
 - Improve writing
 - Add and update links
2020-08-23 05:57:37 -05:00
Andrew David Wong fe63cd7ce7
Update mailing list links 2020-08-22 23:57:32 -05:00
Andrew David Wong 60864a532c
Update qubes-users references to /support/
Now that we have a user forum in addition to qubes-users, it makes more
sense to link to /support/ than to link directly to qubes-users (or to
the forum, for that matter). This layer of redirection means allows us
to update just one thing (namely, the /support/ page) instead of having
to hunt through all the documentation every time support information
changes.
2020-08-22 23:18:08 -05:00
Andrew David Wong bad0dbd97b
Update reference to discussion guidelines 2020-08-20 12:18:31 -05:00
Andrew David Wong 9851709887
Add forum information; improve organization 2020-08-20 11:56:57 -05:00
Andrew David Wong d022adc5f9
Add section for unofficial chat channels 2020-06-04 09:39:32 -05:00
Andrew David Wong 16c05f8f80
Update the description of a "qube" 2020-06-04 08:03:26 -05:00
Souphorn 2eac0c9483 image looks better, not stretch, from small screen 2020-04-30 21:05:18 +07:00
deathgrippin c2fd7a73c0
Fix formatting and typos 2020-03-21 15:24:59 -04:00
Avery Uslaner dd47bf066d
Fixed Typo in website repo URL 2020-03-06 18:33:15 -07:00
unman 9999208db7
FAQ - fix last broken link 2020-02-21 02:02:09 +00:00
unman b0a61516b0
FAQ - fix links and generfal reformat 2020-02-21 01:48:47 +00:00
Michael Carbone 1842bbd240
removed titles as redundant given links to profiles 2020-02-17 13:16:08 -05:00
Michael Carbone c20e923268
clarify CoC process based on Mozilla feedback
https://github.com/mozilla/diversity/blob/master/evaluation_tools/governance-basic.md#code-of-conduct
2020-02-17 13:13:51 -05:00
AJ Jordan c215b79704
Fix some links in the FAQ
Ref QubesOS/qubes-issues#5537
2020-01-23 16:00:28 -05:00
awokd 2916c08bf8
Add entry for Load Kernel Modules message 2020-01-04 21:54:14 +00:00
Andrew David Wong 34861e6ee4
Merge branch 'patch-4' of https://github.com/luzeal/qubes-doc into luzeal-patch-4 2019-12-15 07:50:33 -06:00
Lukas 0496cc0a6e
Update links in intro.md
I have corrected broken links, including the first to the Xen project wiki and the one mentioned by Marek. I reviewed other links as well to be sure they are working
2019-12-14 17:16:30 +01:00
Lukas 0033220ac1
Fix reported spelling errors on intro.md
There were a few typos. I corrected them. Hopefully, none remain.
2019-12-14 13:16:48 +01:00
Lukas 2d1bf16717
Third update to intro.md
I have created another pull request to revise the introduction page. It replaces : #871, which will eventually need to be dropped. 
This pull request is linked to issue [5357](
https://github.com/QubesOS/qubes-issues/issues/5357).

Besides some formatting changes (one line per sentence ; ### Title ###), I have slightly modified the text in the "why" section. 

Thanks !
2019-11-29 19:32:57 -06:00
Lukas 125e927bfd
Update faq.md with contents from intro
Formatting issue corrected (missing ### line 139)
2019-11-29 17:20:14 -06:00
Lukas 0c9d3d4b8e
Update faq.md with contents from intro
I have added the content from the intro into the FAQ so it doesn't get lost in case the intro page changes.
2019-11-27 11:46:25 -06:00
Theodore Chu 83c9c72618
Update faq.md
added details about whether we can install Qubes without VT-x and VT-d
2019-11-24 19:47:11 -08:00
Andrew David Wong 2aeb8298c6
Remove link to retired unofficial forum
See: https://groups.google.com/d/msg/qubes-users/xXzLgVH7HD8/s1qFZHhRAgAJ

Fixes QubesOS/qubes-issues#5411
2019-10-23 21:34:49 -05:00
Andrew David Wong 1d554658bc
Fix links 2019-09-02 05:03:21 -05:00
Andrew David Wong dbc5b67b64
Update link to "Installing and updating software in dom0" 2019-08-26 20:12:55 -05:00
Andrew David Wong c61e0d7118
Update links 2019-08-13 23:43:03 -05:00
Andrew David Wong 1cd77c708d
Update Experts page 2019-08-13 23:24:07 -05:00
Andrew David Wong d31c786942
Reorganize files to account for new "External" section
QubesOS/qubes-issues#4693
2019-05-26 19:32:45 -05:00