254 Commits

Author	SHA1	Message	Date
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
Andrew David Wong	deb33cde69	Copyedit text	2021-05-23 20:36:41 -07:00
Patrick Schleizer	7706060a47	clarify Qubes source code license ... part of https://github.com/QubesOS/qubes-issues/issues/6500	2021-05-23 13:56:28 -04:00
herypt	90cf4497e4	Fix outdated documentation	2021-05-13 11:54:02 +02:00
Andrew David Wong	a660a92634	Merge branch 'resolve-transifex-issues' of https://github.com/tokideveloper/qubes-doc into tokideveloper-resolve-transifex-issues	2021-04-19 16:00:14 -07:00
Andrew David Wong	593f728ed6	Fix typo	2021-04-17 14:54:26 -07:00
Tobias Killer	190b740e32	Resolve open issues mentioned on Transifex	2021-04-17 10:31:11 +02:00
Tobias Killer	617330d026	Resolve open issues mentioned on Transifex	2021-04-16 19:45:56 +02:00
deeplow	bf64b68bcb	typo	2021-04-16 16:22:32 +00:00
Andrew David Wong	d2fa42c1e9	Merge branch 'md-refactoring-links' of https://github.com/tokideveloper/qubes-doc into tokideveloper-md-refactoring-links	2021-04-15 08:57:06 -07:00
Andrew David Wong	26f3a6567b	Fix broken link syntax cases ... Thank you to Tokidev for pointing these out.	2021-04-12 13:40:09 -07: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	b546de3b8d	Merge branch 'md-convention-fullreflinks' of https://github.com/tokideveloper/qubes-doc into tokideveloper-md-convention-fullreflinks	2021-04-09 15:26:52 -07:00
Tobias Killer	7250daea53	Rewrite Markdown convention rule: Do not allow reference links	2021-04-09 09:30:39 +02:00
Andrew David Wong	248673e25e	Update instructions for adding doc index links ... Discussed in QubesOS/qubes-issues#6426	2021-04-08 06:37:48 -07:00
Tobias Killer	ada42d7023	Add Markdown convention rule about full reference links	2021-04-08 11:25:36 +02:00
Marek Marczykowski-Górecki	16d88ced36	Add ref/lang to GSoD page ... Commit this manually until CI is set for this task	2021-03-29 06:20:25 +02:00
Marek Marczykowski-Górecki	cbfdf2d7ca	Fix broken links on GSoD page	2021-03-29 02:33:16 +02:00
Marek Marczykowski-Górecki	752f1d4ddc	Fix over indented code blocks	2021-03-28 20:58:39 +02:00
Andrew David Wong	d328b1b1c9	Merge branch 'translation-prepare' of https://github.com/marmarek/qubes-doc into marmarek-translation-prepare	2021-03-26 20:46:10 -07:00
Michael Carbone	9c87e51d9c	fix formatting, remove duplicate past projects	2021-03-25 08:05:05 -04:00
Michael Carbone	84df7767fe	update GSoD page to follow application instructions ... see instructions: https://developers.google.com/season-of-docs/docs/org-proposal-template	2021-03-25 07:28:11 -04: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
Maya	2bde7d07e0	Rename files to avoid dots in the path ... This is problematic for Transifex API and also ease building language-specific links.	2021-03-13 20:11:39 +01:00
Andrew David Wong	b55ef9ee68	Merge branch 'update-gsod' of https://github.com/PROTechThor/qubes-doc into PROTechThor-update-gsod	2021-03-10 21:47:46 -08:00
Marek Marczykowski-Górecki	948525f97a	Add some new projects for GSOC 2021	2021-02-18 02:17:59 +01:00
Marek Marczykowski-Górecki	a240458a8c	GSOC: Remove completed projects, hide in progress ones	2021-02-18 01:37:47 +01:00
Marek Marczykowski-Górecki	b2f5ff7ce5	Merge remote-tracking branch 'origin/pr/1116' ... * origin/pr/1116: Updates for GSoC 2021	2021-02-18 01:34:09 +01:00
E. Cleopatra	b43e72a82c	Updates for GSoC 2021	2021-02-18 00:33:55 +01:00
E. Cleopatra	ff38102071	Update for GSoD 2021, Show past projects	2021-02-17 23:17:18 +01:00
Crsi	fae89440aa	Removed a doubled 'placed'	2021-02-15 19:11:19 +01:00
deeplow	f9bc36676d	undo second link	2021-01-06 15:06:25 +00:00
deeplow	58cf8aecc8	fix broken links to github	2021-01-06 15:02:24 +00:00
Andrew David Wong	6e9d015c50	Add info on adding and updating community links in ToC ... QubesOS/qubes-issues#4693	2020-12-25 08:21:46 -08:00
Robin Schneider	a14070badc	Update URL with 301 permanently moved HTTP status code	2020-12-21 17:38:17 +01: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	7610a66873	Update doc guidelines to reflect completed migration ... https://github.com/QubesOS/qubes-issues/issues/4693	2020-12-07 22:57:40 -08:00
Andrew David Wong	e7568e9808	Update link	2020-12-07 18:40:52 -08:00
Andrew David Wong	c02686c6df	Update guidance regarding relative vs. absolute links	2020-12-07 17:09:34 -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
Andrew David Wong	c1f1ee902c	Update image linking syntax; use syntax on same page	2020-12-01 21:37:45 -08:00
Andrew David Wong	d33cd36170	Update examples; fix typo	2020-12-01 21:29:22 -08:00
Andrew David Wong	2c3293ddd1	Add missing link	2020-11-29 12:47:10 -08:00
Andrew David Wong	fa826f6066	Add guidelines on duplication and core vs. external docs ... - Add new "Organizationl guidelines" section - Add some relevant links in other sections - Update heading syntax to account for new h3s - Normalize heading case	2020-11-29 12:43:48 -08:00
Andrew David Wong	63379e80c6	Remove reference-style link guideline ... Closes #1096	2020-11-23 10:17:10 -08:00
Andrew David Wong	3df2ffa6f6	Add guideline on syntactically distinguishing variables in commands	2020-11-23 07:08:35 -08:00
Andrew David Wong	17021f6cb7	Update doc guidelines regarding HTML, CSS, and images	2020-11-18 22:26:22 -08:00
Marek Marczykowski-Górecki	d2c9f07bbc	license: drop note about dual-licensing ... This was never enforced (and the way it's written is not enforceable). So, lets remove dead text. If we'd like to enforce something like this in the future, we'd need to require contributors signing CLA. But it wouldn't apply to past contributions anyway.	2020-11-13 13:22:35 +01:00
pierwill	dca896aacd	Fix markdown links ... Fixes two malformed links in qrexec socket services doc.	2020-11-12 21:19:11 -08:00
Andrew David Wong	0e5a97785c	Add information about doc review security	2020-10-27 19:23:57 -07:00
Andrew David Wong	e87bb670ee	Add instructions for installing contributed packages	2020-10-19 11:39:51 -07:00
Andrew David Wong	8d6fc28c1a	Merge branch 'patch-3' of https://github.com/dmoerner/qubes-doc into dmoerner-patch-3	2020-10-09 20:39:07 -05:00
Andrew David Wong	9169458de8	Link to build security post	2020-10-09 19:29:43 -05:00
Daniel Moerner	ded05b0260	Update qubes-builder.md ... PyYAML has been renamed to python3-pyyaml in newer versions of Fedora.	2020-10-03 21:39:32 -04:00
Marek Marczykowski-Górecki	067368ea70	fix formatting	2020-10-04 03:24:06 +02:00
Frédéric Pierret (fepitre)	7a0c466b27	Update qubes-iso-building	2020-09-22 12:36:53 +02:00
Andrew David Wong	3301c561e7	Merge branch 'policy-api' of https://github.com/pwmarcz/qubes-doc into pwmarcz-policy-api	2020-09-18 01:33:31 -05:00
Bryce Guinta	256b02d0d3	Document use of xl info to find total memory ... I had to do some digging to figure out why I thought dom0 was reporting an incorrect amount of total memory available, and finally found this command. This document comes up very high in the search results for Qubes memory so I thought I'd put it here since it provides some concrete context to the architecture.	2020-08-29 18:59:09 -04:00
Andrew David Wong	9b9d291256	Recommend universal Atx-style headings	2020-08-29 15:42:03 -05:00
Andrew David Wong	0db36137aa	Update arch spec PDF description ... Be even more explicit about its historical nature.	2020-08-28 11:59:10 -05:00
Paweł Marczewski	e7a882a497	Add documentation for policy admin API	2020-08-25 14:43:36 +02:00
WillyPillow	c8d0ee78d5	Add docs for admin.vm.Volume.Clear.	2020-08-10 11:29:11 +08:00
Andrew David Wong	c58ff2df3d	Note that arch spec PDF is for historical interest	2020-08-07 00:39:03 -05:00