permacomputing

Source repository for the main permacomputing wiki site
git clone http://git.permacomputing.net/repos/permacomputing.git # read-only access
Log | Files | Refs

commit b5b2171b9b0456c5717ea5e40705eb281aa21a65
parent 35663303d2738a5c40c29accd1924ac1fa9db919
Author: ugrnm <ugrnm@web>
Date:   Fri, 10 Jun 2022 15:15:06 +0200

empty web commit

Diffstat:
Mediting.mdwn | 36+++++++++++++++++-------------------
1 file changed, 17 insertions(+), 19 deletions(-)

diff --git a/editing.mdwn b/editing.mdwn @@ -22,35 +22,33 @@ At the current stage of maturity of PW, it is often not advisable to write a com 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. See below. -## Attribution and quotes +## Attribution, quotes and footnotes -If you rely on other sources for the writing of a section, do not be lazy or mindlessly copypaste from other sources. You must properly attribute your source. You have 4 options: +If you rely on other sources for the writing of a section, do not be lazy or mindlessly copypaste from other sources. In general, **do not invisibilize people from which you took inspiration and/or learned something from**. Take the opportunity of contributing to this wiki to also point to their work and research. You must properly attribute your source. You have 4 options: -### Hyperlinks +* **Hyperlinks:** Sometimes it's enough to point to external reference as an hyperlink if there is not much to discuss. For instance [Ursula Leguin has an interesting take on technology](http://www.ursulakleguinarchive.com/Note-Technology.html). +* **Footnotes:** Can be handy to drift a bit[^drift] but also to give a proper footnote reference when paraphrasing and referencing the thoughts of someone else. For instance Ursula Leguin has been critical of a specific usage of the work *technology* when misused to only refer to the most recent developments, which also happen to be the most problematic[^leguinref]. +* **Inline quotes:** Use this with footnotes when you want to quote something short inline. For instance Ursula Leguin offers to understand technology more broadly as "the active human interface with the material world"[^leguinrefquote]. +* **Block quotes:** Finally, you may want to quote entirely a part of someone else's writing, in which case, use the block quote formatting, with a footnote for the reference. For instance here is how Ursula Leguin suggests to reconsider how we use the word *technology*: -Sometimes it's enough to point to external reference to [[technology]](https://en.wikipedia.org/wiki/Technology) if there is not much to discuss. - -### Footnotes - -TODO needs to read how to do it properly with ikiwiki +> Technology is the active human interface with the material world. +> But the word is consistently misused to mean only the enormously complex and specialised technologies of the past few decades, supported by massive exploitation both of natural and human resources. +> This is not an acceptable use of the word. [^leguinrefquote2] -### Inline quotes +[^drift]: parenthesis could be used as well, sure, or long — em dashes, but if you're going to fork the discussion to something that's too long to fit in the flow of the main text, and that does not need its own page, then a footnote can be quite handy. +[^leguinref]: See Ursula Leguin, "A Rant About 'Technology'," 2004, [http://www.ursulakleguinarchive.com/Note-Technology.html](http://www.ursulakleguinarchive.com/Note-Technology.html). +[^leguinrefquote]: Ursula Leguin, "A Rant About 'Technology'," 2004, [http://www.ursulakleguinarchive.com/Note-Technology.html](http://www.ursulakleguinarchive.com/Note-Technology.html). +[^leguinrefquote2]: Ursula Leguin, "A Rant About 'Technology'," 2004, [http://www.ursulakleguinarchive.com/Note-Technology.html](http://www.ursulakleguinarchive.com/Note-Technology.html). -Sometimes ... need to solve footnot first +#### Limitations of the footnotes -### Block quotes +This it not biblatex/biber. So as you can see in the examples above, you cannot reuse and existing footnote, and there is not elegant handling of repetition (no Ibid.). -Sometimes you just need to fully quote a text from someone and it can as simple as: +#### Reference style -> Technology is the active human interface with the material world. -> But the word is consistently misused to mean only the enormously complex and specialised technologies of the past few decades, supported by massive exploitation both of natural and human resources. -> This is not an acceptable use of the word. -> -> Usula Leguin, 2004, [A Rant About "Technology"](http://www.ursulakleguinarchive.com/Note-Technology.html) +When referencing, please use the [Notes and Bibliography version of The Chicago Manual of Style](https://www.chicagomanualofstyle.org/tools_citationguide/citation-guide-1.html). However, this is not an academic paper, don't overthink it or spend ages on it, try to make it work as best as you can, it's just to have some overall consistency. No sweat :) -### Please -In general, **do not invisibilize people from which you took inspiration and/or learned something from**. Take the opportunity of contributing to this wiki to also point to their work and research. ## Acceptable content