commit 8e5acbc77c014df84a55d4bdc4fece124524d43f
parent 0b08ebc69eeaca0236c376cc52ba5deebdb6e616
Author: ugrnm <ultrageranium@bleu255.com>
Date: Fri, 10 Nov 2023 18:07:07 +0100
editing editing a bit more
Diffstat:
| M | editing.mdwn | | | 67 | +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++-------- |
1 file changed, 59 insertions(+), 8 deletions(-)
diff --git a/editing.mdwn b/editing.mdwn
@@ -1,7 +1,10 @@
Access
------
-You are very welcome to contribute to this wiki!
+You are very welcome to contribute to this wiki! Basically any topic is allowed
+as long as it can be discussed from a permacomputing-relevant point of view.
+For an outline of the kind of topics we are particularly interested in, see the
+front page.
You can [[contact]] us by email for an account. Please:
@@ -16,13 +19,6 @@ Please cover these four points, we won't process/reply vague or incomplete
requests. Really, we won't. It may take a few days for us to get back to you.
-### What belongs on this wiki?
-
-Basically any topic is allowed as long as it can be discussed from a
-permacomputing-relevant point of view. For an outline of the kind of topics we
-are particularly interested in, see the front page.
-
-
Style
-----
@@ -33,6 +29,61 @@ may not agree with, please use the relevant Discussion page, and make sure to
sign your comment with your handle. Go to the Discussion page, in the top menu
of this page for an example.
+
+Copyediting recommendations
+---------------------------
+
+
+1. explain the abbreviations before using it (ex. Operations Systems (OS) are
+ amazing. The OS are actually shit).
+
+2. make sure the references are explained before using them. (ex. "Unix is a
+ multi-user operating system whose development was started in 1969 by Ken
+ Thompson and Dennis Ritchie, as well as an entire family of operating system
+ derived from the original Unix." First, explain the original Unix, or
+ rearrange the sentences where you explain what unix is, then explain that
+ there are multiple versions, an original and others). Some for people
+mentioned, quotations etc.
+
+3. explain the relevance of quotations. (Ex. here
+ https://permacomputing.net/wiki/ the quote is not introduced, the relevance
+ is implied but not explained.
+
+4. transition between paragraphs, quotes etc. is key. similar to the rule
+ above, make sure the paragraphs are transitioning from one point to another.
+
+5. avoid jargon. if a technical/academic/etc. term needs to be used, maybe it
+ needs its own page as well. (i.e. "it refers to a very specific kind of
+ "digital", a highly technoprogressivist and industry-defined kind that
+ became prominent in the "digital revolution" hype of the 1990s."
+ technoprogressivist is not a common word that could be understood easily,
+ either provide a short explanation or make a page for it)
+
+6. check if there are other pages you can crosslink in your text (i.e. you
+ mention hardware, link the hardware page there)
+
+7. avoid using brackets (as much as possible), it breaks the reading (and
+ comprehending) flow (quite a bit).
+
+8. avoid passive-aggresive language. rather, explain why some concepts are
+ wrong/didn't work/is bad. (i.e. "digital revolution" hype of the 1990s. why
+ was it a hype?)
+
+9. make sure all formatting choices are unified in your text. (i.e.
+ https://permacomputing.net/Principles/ here, the sub-principles are written
+ as a paragraph first, and then as list. should be the same style).
+
+10. use formatting sparingly and with purpose.
+
+11. avoid repetation and redundant words, be concise, simple, clear.
+
+12. don't forget to click save! :D
+
+
+
+
+
+
At the current stage of maturity of PW, it is often not advisable to write a comprehensive articles about a topic if someone else has already done it elsewhere. Put in a link to that external resource instead. (In the future, we will perhaps want to host copies of all these "dependencies" in the local repository as well, but not yet.)
When introducing a new term, please try to include a proper and non-biased definition of the topic before proceeding to the permacomputing-specific points of view. You can use [[Wikipedia]] or other sources for this, **just make sure you properly attribute and quote** (we are CC0, Wikipedia is CC-BY-SA, so you can't just copy-and-paste even from there). See below.
