Commit Graph

420 Commits

Author SHA1 Message Date
Marek Marczykowski-Górecki
a1a6e80d84
Document PipelineRetryFailed
https://github.com/fepitre/qubes-g2g-continuous-integration/pull/3
2022-07-22 15:31:01 +02:00
Andrew David Wong
add0ebf529
Clarify release number usage 2022-07-04 20:58:37 -07:00
Demi Marie Obenour
36d730957a
Update GUI protocol documentation
This adds documentation for the protocol extensions in R4.1, which
replace some older messages.  The new messages allow the GUI daemon to
run outside of dom0.  Additionally, the English has been cleaned up, and
Markdown syntax improved.
2022-05-21 11:25:19 -04:00
Marek Marczykowski-Górecki
2171e182ee
Use https to clone qubes-builder
Builder config points at https for a long time, but the documentation
still used git:// protocol. Update that, especially as github
discontinued support for it.
2022-03-16 13:38:12 +01:00
Marek Marczykowski-Górecki
35a7fc5736
GSoC: fill in project difficulties and size 2022-02-25 20:53:20 +01:00
Marek Marczykowski-Górecki
5ac871d85a
gsoc: update projects list
- wayland is in progress
- add system health monitor
- remove qvm-create-windows-qube - already exists in the community
- add link to GSoC 2021 archive
2022-02-21 17:07:52 +01:00
Michael Carbone
8cb3af767a
updated language gsoc
updated "student" -> "contributor", made accurate timeline.

see https://opensource.googleblog.com/2021/11/expanding-google-summer-of-code-in-2022.html for more info.
2022-02-21 04:30:54 -05:00
Andrew David Wong
028d0fd5dc
Merge branch 'master' of github.com:p1xxxel/qubes-doc into p1xxxel-master 2022-02-10 18:39:47 -08:00
Ayusman Samal
8cb2b1dbe1
added working keyservers for clarity
Co-authored-by: siliconninja <theninja@thesilicon.ninja>
2022-02-07 22:50:04 +05:30
Marek Marczykowski-Górecki
88905d02cf
Add final release date to the R4.1 release schedule 2022-02-04 23:02:33 +01:00
Andrew David Wong
4634c8c7d9
Update links (QubesOS/qubes-issues#7119) 2022-02-02 19:46:02 -08:00
Andrew David Wong
a17976bffb
Wrap text 2022-02-02 18:03:24 -08:00
Andrew David Wong
5628f27f8f
Add "Windows USB and audio support courtesy of tabit-pro" 2022-02-02 18:01:05 -08:00
Andrew David Wong
4854d35586
Merge branch 'pgp-instruction-improvements' of github.com:siliconninja/qubes-doc into siliconninja-pgp-instruction-improvements 2022-01-08 13:47:00 -08:00
Marek Marczykowski-Górecki
9f309c198b
Update R4.1 release schedule
Move rc4 a bit earlier - there are only few bugs, and they already have
fixes developed, so give more time for testing instead.
2022-01-07 04:18:09 +01:00
siliconninja
023db35924
Fix git commit code signing command 2022-01-06 14:11:44 -05:00
Andrew David Wong
ba6d93a078
Fix typo 2022-01-02 18:57:19 -08:00
deeplow
7e8ea7b0c3
add documentation for openqa_investigator script 2022-01-02 03:21:38 -05:00
Ayusman Samal
a130e17974
Updated instructions with new gpg version and removed depreciated key server 2021-12-31 12:50:02 +05:30
deeplow
900656fc7c
note possibility to add rpc services in app qube
The technical possibility can be found here: https://github.com/QubesOS/qubes-issues/issues/3003
2021-12-14 10:43:24 -05:00
Marek Marczykowski-Górecki
a1517c2dcb
schedule: there will be 4.1.0-rc3 2021-11-30 21:02:58 +01:00
runephilosof-abtion
b4f109c711
Fix link to open bug reports 2021-11-25 09:41:32 +01:00
Andrew David Wong
e7851569f1
Add links; improve language 2021-10-11 16:03:29 -07:00
Marek Marczykowski-Górecki
9610702add
Add R4.1 release schedule 2021-10-11 01:36:02 +02:00
Marek Marczykowski-Górecki
5126c58f29
Rename release notes file to match others 2021-10-11 01:30:37 +02:00
Marek Marczykowski-Górecki
c02f15dffc
Update R4.1 release notes 2021-10-11 01:29:48 +02:00
Andrew David Wong
e605e7965b
Update link 2021-10-11 01:29:48 +02:00
Andrew David Wong
dfac1d2866
Add link to "Upgrading to R4.1" 2021-10-11 01:29:48 +02:00
Andrew David Wong
e5167e0b27
Clarify "Grub in UEFI mode" 2021-10-11 01:29:48 +02:00
Andrew David Wong
a87b25a433
Add QubesOS/qubes-issues#6877 to release notes 2021-10-11 01:29:48 +02:00
Andrew David Wong
cd0745c1c5
Update Qubes OS 4.1 release notes
- Add issues bearing the "release notes" label on the 4.1
  milestone (incomplete items should be removed before finalizing)
- Improve language
- Standardize syntax and formatting
2021-10-11 01:29:48 +02:00
Marek Marczykowski-Górecki
64d3119dd6
Add R4.1 release notes draft 2021-10-11 01:29:48 +02:00
Andrew David Wong
e06f89025a
Merge branch 'patch-24' of https://github.com/deeplow/qubes-doc into deeplow-patch-24 2021-10-01 07:37:21 -07:00
Andrew David Wong
82026dfd80
Merge branch 'qvm-template' of https://github.com/WillyPillow/qubes-doc 2021-10-01 07:29:29 -07:00
Andrew David Wong
9f19553faf
Note exception for templates 2021-09-10 15:48:33 -07:00
Andrew David Wong
2a70624386
Update "version scheme"
- Minor clarification
- Improve formatting
- Fix and improve orthography
- Make image a link
2021-09-06 23:06:13 -07:00
Andrew David Wong
dbb3c3c4ac
Update "version scheme"
- Add info about major, minor, and patch releases
- Add info about common abbreviations
- Add links
- Improve language
- Improve formatting
- Fix typos
- Convert table from HTML to Markdown
2021-09-06 22:49:07 -07:00
Andrew David Wong
2774c83a98
Update intro to explain basic versioning and terminology 2021-09-06 22:05:21 -07:00
Andrew David Wong
3da0cd8e8e
Fix link URL and title; wrap text 2021-09-06 15:59:45 -07:00
Sven Semmler
c00bdec059
add link to external documentation
I just copy & pasted this part of the page into an [answer on the forum](https://forum.qubes-os.org/t/6189/) and realized it would be nice if "External documentation" would also be hyperlinked. If there is a reason this was not done, please just ignore this PR.
2021-09-06 16:40:54 -05:00
Andrew David Wong
a3364eed21
Remove specific Qubes version refs and warn against this mistake 2021-08-13 02:45:58 -07:00
Andrew David Wong
59aab04f08
Revise in accordance with documentation style guide 2021-08-04 22:22:12 -07:00
Andrew David Wong
f4177b4554
Merge branch 'qvm-template' of https://github.com/WillyPillow/qubes-doc 2021-08-04 22:21:34 -07:00
Andrew David Wong
b7dcfb64bb
Update developer/system/template-manager.md
Co-authored-by: Marta Marczykowska-Górecka <marmarta@users.noreply.github.com>
2021-08-04 21:41:08 -07:00
deeplow
1b9ce8d98d
remove unneeded qubesd restart 2021-08-04 09:59:42 -04:00
Andrew David Wong
a605052c80
Add "videos" 2021-08-03 15:11:12 -07:00
Andrew David Wong
ee309abd0a
Attempt to document PipelineRefresh
See https://github.com/QubesOS/qubes-posts/pull/82#issuecomment-888231099
2021-07-28 22:20:39 -07:00
Andrew David Wong
54525b2e09
Update links; fix typo 2021-07-20 03:27:51 -07:00
deeplow
90b411720e
add bash as code-block language 2021-07-19 09:11:35 -04:00
Andrew David Wong
481b75761b
Add missing article 2021-07-18 18:49:58 -07:00
deeplow
98ca7b8f43
fix captizalization 2021-07-17 11:11:35 -04:00
deeplow
390f3eb43d
fix typo 2021-07-17 11:08:52 -04:00
deeplow
2896c019eb
Fix captization & add links 2021-07-17 11:07:59 -04:00
deeplow
d2e7232432
minor fixes 2021-07-15 06:35:45 -04:00
deeplow
715da559ce
test-bench: section on installing testing deps 2021-07-15 06:33:49 -04:00
Andrew David Wong
db56549748
Move files back to qubes-doc so they can appear in index
I'm still not sure why these files have to be in qubes-doc in order to
appear in the doc index, but they do, so I'm moving them back even
though they're mostly empty.
2021-07-14 11:20:16 -07:00
Andrew David Wong
6eea2bf394
Fix typo 2021-07-10 15:03:56 -07:00
Andrew David Wong
e89bc971ae
Update terminology 2021-07-10 14:47:15 -07:00
Andrew David Wong
ca0ccab949
Update titles and links 2021-07-10 14:25:29 -07:00
Andrew David Wong
a1967f09ad
Fix typo 2021-07-10 14:19:45 -07:00
Andrew David Wong
ef3440228f
Cross-link doc style guide and how-to pages 2021-07-10 13:49:27 -07:00
Andrew David Wong
b9bf32e6f8
Add section on serving website locally 2021-07-10 13:19:24 -07:00
Andrew David Wong
6de3d7f75f
Fix typo 2021-07-10 13:16:07 -07:00
Andrew David Wong
473f1075c8
Update example to reflect current style guide 2021-07-10 13:08:13 -07:00
Andrew David Wong
f608865417
Update doc style guide and instructions
- Explain why image linking is important
- Improve wording
- Fix link
- Minor improvements
2021-07-10 12:52:48 -07:00
Andrew David Wong
294e433b3d
Remove note about QubesOS/qubes-issues#6769 (fixed) 2021-07-09 05:19:05 -07:00
Andrew David Wong
a18174dc5e
Fix capitalization; update terms (QubesOS/qubes-issues#6769)
Thank you to @unman for the initial sentence case pass.
2021-07-09 05:10:44 -07:00
Andrew David Wong
ad2c60d91d
Merge branch '6769' of https://github.com/unman/qubes-doc into unman-6769 2021-07-09 04:23:31 -07:00
unman
d0bc9e70a2
Sentence case for titles 2021-07-09 01:06:41 +00:00
Andrew David Wong
e09d2d4c7a
Use shorter anchor text for doc index link 2021-07-08 10:17:34 -07:00
Andrew David Wong
bc5276a290
Improve section organization, formatting; fix link 2021-07-08 10:14:31 -07:00
Andrew David Wong
a867dbe06a
Add note about QubesOS/qubes-issues#6769 2021-07-08 08:24:13 -07:00
Andrew David Wong
d9ce14a1d0
Rename files in accordance with commit 676a13b 2021-07-08 08:09:41 -07:00
Andrew David Wong
c29cf40910
Reorganize doc guidelines into multiple pages; update style guide
The existing doc guidelines page attempts to combine too many different
topics at once and includes information that does not pertain directly
to the documentation. This reorganization is intended to make each type
of information easier to find. For example, some have found it difficult
to find the documentation style guidelines (see, e.g.,
QubesOS/qubes-issues#6701#issuecomment-875875610). This reorganization
allows us to assign more specific titles to each page.

General changes:
- Create new page for contribution instructions
- Create new page for website style guide
- Create new page for continuous integration
- Rename existing "style guide" to "visual style guide" in order to
  avoid ambiguity with new doc and website style guides
- Retain existing page solely for doc style guide
- Update page names and permalinks
- Update existing links
- Improve language

Doc style guide changes:
- Add section on using sentence case in headings
  (see QubesOS/qubes-issues#6756 and #1173)
- Improve section organization
- Clarify language

In order to better preserve the Git history of each file, file renames
will be handled in a separate commit.
2021-07-08 08:08:57 -07:00
Andrew David Wong
eca8b6fb05
Merge branch 'patch-22' of https://github.com/deeplow/qubes-doc into deeplow-patch-22 2021-07-06 07:12:27 -07:00
Andrew David Wong
07da69bc0e
Revamp "Documentation Guidelines"
- Update contribution steps and first two images
- Improve source formatting and consistency
- Add information
- Improve organization and add subheadings
- Clarify and improve wording
2021-07-06 06:25:33 -07:00
deeplow
5972274c9d
start also script 2021-07-06 08:09:53 -04:00
deeplow
9849fea742
add steps to run script on every boot 2021-07-06 08:08:08 -04:00
deeplow
d00c2d932f
Minor improvements to the testbech instructions 2021-07-05 11:47:54 -04:00
Andrew David Wong
28bfb5c224
Capitalize second word in title case compound adjectives
https://github.com/QubesOS/qubes-issues/issues/6756#issuecomment-873385039
2021-07-03 15:43:16 -07:00
Andrew David Wong
5220089b53
Update references to "Getting Started"
QubesOS/qubes-issues#6756
2021-07-03 03:46:27 -07:00
Andrew David Wong
baa1df911c
Update Qubes Forum URLs 2021-07-01 07:03:05 -07:00
Andrew David Wong
fd6c8e28f8
Document wwwtest vs. wwwpreview
QubesOS/qubes-issues#6747
2021-06-29 15:44:02 -07:00
Andrew David Wong
3253b6b91e
Update TestDeploy documentation
QubesOS/qubes-issues#6747
2021-06-29 14:58:18 -07:00
Andrew David Wong
dc22de87ab
Document TestDeploy 2021-06-29 14:23:26 -07:00
Andrew David Wong
decc4135f9
Add CI section; document PipelineRetry command (#1149) 2021-06-27 22:35:56 -07:00
Andrew David Wong
1c5aab4340
Add guidelines regarding angled brackets around variables
Added in response to:
https://qubes-os.discourse.group/t/how-can-i-create-a-template-hvm-of-any-os/4676

Also updates terminology and clarifies wording.
2021-06-27 22:25:46 -07:00
Yann Dirson
04c8ea50b0 qubes-builder: fix typo in rpmmacros filename, improve its markup 2021-06-26 17:34:47 -04:00
Andrew David Wong
4f26651215
Merge branch 'patch-17' of https://github.com/deeplow/qubes-doc into deeplow-patch-17 2021-06-26 06:28:21 -07:00
Andrew David Wong
38fb2978c3
Wrap text 2021-06-26 06:02:01 -07:00
Andrew David Wong
1ddbdc77e4
Merge branch 'patch-57' of https://github.com/adrelanos/qubes-doc into adrelanos-patch-57 2021-06-26 06:01:36 -07:00
Marek Marczykowski-Górecki
4017d11de3
Run script to add 'ref' parameters 2021-06-24 18:19:05 +02:00
Marek Marczykowski-Górecki
3806ecf338
Remove extra newlines at the beginning/end of files
Those are redundant, and yaml parser strips them in fact. By removing
them, loading and saving yaml file without any change indeed produce the
same output. This is useful for prepare_for_translation.py script (which
adds lang and ref tags) - to produce only change that indeed was made.
2021-06-24 16:07:23 +02:00
Andrew David Wong
d145143261
Update Qubes Canary page link 2021-06-22 10:55:21 -07:00
Andrew David Wong
6cc2f9932b
Update QSB page link 2021-06-22 10:50:12 -07:00
Andrew David Wong
d3c9979d7e
Update terminology, links, heading syntax; wrap text 2021-06-22 10:39:03 -07:00
Andrew David Wong
1a4365fadb
Clarify intention and context of coding conventions 2021-06-22 06:05:53 -07:00
Andrew David Wong
c8752a2a57
Add "Coding conventions" section 2021-06-22 05:21:02 -07:00
Andrew David Wong
ef620f97a7
Refactor Admin API page 2021-06-22 01:25:49 -07:00
Andrew David Wong
f86d6c58c6
Move "Research" page to main repo
This file no longer contains any significant content.
2021-06-21 22:10:09 -07:00
Andrew David Wong
673629c976
Update doc index link 2021-06-21 21:03:28 -07:00
Andrew David Wong
527a2eb339
Update links 2021-06-21 00:38:18 -07:00
Andrew David Wong
cc839fc10a
Move "Version Scheme" to developer docs
This page appears to be written for a developer audience.
2021-06-19 20:41:11 -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
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
863f0ee9bd
Revert "Fix image example; wrap text"
This reverts commit 7d7ca0c592.
2021-06-18 05:39:28 -07:00
Andrew David Wong
7d7ca0c592
Fix image example; wrap text 2021-06-18 05:27:55 -07:00
Andrew David Wong
b1d6139120
Restore hard wrapping at 80 characters
Turns out it's not a problem for localization, and it has significant
benefits. See the discussion on QubesOS/qubes-issues#2639 for details.
2021-06-18 05:17:57 -07:00
Andrew David Wong
e5a21f7488
Update attachment paths 2021-06-18 05:02:02 -07:00
deeplow
99083295b0
qubes-dom0-update has no install argument 2021-06-18 08:53:15 +00:00
deeplow
d33690dfd6
clarify "dnf --setopt" should be used 2021-06-17 17:03:48 +00:00
Andrew David Wong
d2614cbd5f
Fix links 2021-06-17 09:23:17 -07:00
deeplow
4239ad7856
add "ssh-copy-id" to "Passwordless SSH Login" 2021-06-17 11:30:00 -04:00
deeplow
161a03f7bc
add notes about installing software with dom0 net
Add notes on how one can install software if the only network card was already to dom0.
2021-06-17 11:29:58 -04:00
deeplow
036d89eaa0
add troubleshooting message 2021-06-17 11:29:56 -04:00
deeplow
185f33eb7e
implemented requested changes 2021-06-17 11:29:54 -04:00
deeplow
0a6f37156e
update 7-year-old test-bench machine setup
Updates the developer documentation for remote test bench
2021-06-17 11:29:52 -04: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
84d3334325
Update doc guidelines about h1 headings and titles
QubesOS/qubes-issues#6701
2021-06-16 21:49:49 -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
4ff7430960
Remove redundant h1 titles using # syntax
https://github.com/QubesOS/qubes-issues/issues/6701#issuecomment-862060759
2021-06-16 00:29:28 -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
aca8ed14c7
Normalize instances of redirect_from:
QubesOS/qubes-issues#6701
2021-06-15 22:24:44 -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
6043c6e51d
Improve documentation guidelines page
- Create separate section for editing doc index
- Link to how-to-edit-doc-index section in contrib guide
- Link to how-to-edit-doc-index section in core vs. external section
- Link to how-to-add-images section in contrib guide
- Add "PR" abbreviation for those unfamiliar (not used on this
  page but often used elsewhere and when linking to this page)

See QubesOS/qubes-issues#6694
2021-06-13 21:08:10 -07:00
WillyPillow
a77ff318bd
qvm-template: Update constraints regarding template RPM metadata 2021-06-09 17:25:45 +08:00
WillyPillow
76232f9a1f
qvm-template: Change template-licence to template-license 2021-06-09 17:25:43 +08:00
WillyPillow
8716d23f48
qvm-template: Reflect path changes in qubes-repo-templates
See 337efb1d3c.
2021-06-09 17:25:42 +08:00
WillyPillow
2bc69fc466
Tweak slightly for clarity 2021-06-09 17:25:40 +08:00
WillyPillow
2de76980ae
Update info regarding time format 2021-06-09 17:25:38 +08:00
WillyPillow
01110f8253
Fix Google groups link 2021-06-09 17:25:36 +08:00
WillyPillow
96dce2dada
Add indication that qvm-template is not yet merged 2021-06-09 17:25:34 +08:00
WillyPillow
61fb01d673
Move mention of GSoC to Motivations section 2021-06-09 17:25:32 +08:00
WillyPillow
1473712618
Replace with atx headers 2021-06-09 17:25:30 +08:00
Andrew David Wong
a99b53ec11
Remove superfluous "Introduction" heading 2021-06-09 17:25:29 +08:00
WillyPillow
95ee4559ab
Fix incorrect feature name 2021-06-09 17:25:27 +08:00
WillyPillow
dd42704add
Fix link syntax. 2021-06-09 17:25:25 +08:00
WillyPillow
56cf2b768e
Fix whitespace. 2021-06-09 17:25:24 +08:00
WillyPillow
ec37cc6984
Add "Introduction" section. 2021-06-09 17:25:22 +08:00
WillyPillow
3ebde47b23
Replace "template VM" with "TemplateVM". 2021-06-09 17:25:20 +08:00
WillyPillow
54629daa32
Change title to "Template Manager". 2021-06-09 17:25:18 +08:00
WillyPillow
9249f074b3
Fix whitespace. 2021-06-09 17:25:16 +08:00
Andrew David Wong
3b314c84f7
Add YAML header 2021-06-09 17:25:11 +08:00