Browse Source

Principle of self-management

Bob Mottram 7 years ago
parent
commit
70199d2a07
3 changed files with 16 additions and 13 deletions
  1. 1
    0
      code-of-conduct.md
  2. 1
    0
      doc/EN/devguide.org
  3. 14
    13
      website/EN/devguide.html

+ 1
- 0
code-of-conduct.md View File

2
 
2
 
3
  * Enable users to help themselves to provide their own personal software infrastructure.
3
  * Enable users to help themselves to provide their own personal software infrastructure.
4
  * Enable users to help each other to provide software infrastructure for a community.
4
  * Enable users to help each other to provide software infrastructure for a community.
5
+ * Principle of self-management: apps should require miniumum configuration and maintain themselves as far as possible.
5
  * There should be no single point of failure. Assume that other servers can and will fail occasionally.
6
  * There should be no single point of failure. Assume that other servers can and will fail occasionally.
6
  * Minimum data retention. Only store the data which users actually want or need, and within apps implement the function which allows logging to be turned off.
7
  * Minimum data retention. Only store the data which users actually want or need, and within apps implement the function which allows logging to be turned off.
7
  * Respect other users right to run their own stuff and have their own policies on their own hardware.
8
  * Respect other users right to run their own stuff and have their own policies on their own hardware.

+ 1
- 0
doc/EN/devguide.org View File

21
 
21
 
22
  * Enable users to help themselves to provide their own personal software infrastructure.
22
  * Enable users to help themselves to provide their own personal software infrastructure.
23
  * Enable users to help each other to provide software infrastructure for a community.
23
  * Enable users to help each other to provide software infrastructure for a community.
24
+ * Principle of self-management: apps should require miniumum configuration and maintain themselves as far as possible.
24
  * There should be no single point of failure. Assume that other servers can and will fail occasionally.
25
  * There should be no single point of failure. Assume that other servers can and will fail occasionally.
25
  * Minimum data retention. Only store the data which users actually want or need, and within apps implement the function which allows logging to be turned off.
26
  * Minimum data retention. Only store the data which users actually want or need, and within apps implement the function which allows logging to be turned off.
26
  * Respect other users right to run their own stuff and have their own policies on their own hardware.
27
  * Respect other users right to run their own stuff and have their own policies on their own hardware.

+ 14
- 13
website/EN/devguide.html View File

3
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3
 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
4
 <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
5
 <head>
5
 <head>
6
-<!-- 2017-07-18 Tue 10:41 -->
6
+<!-- 2017-07-18 Tue 11:19 -->
7
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
7
 <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
8
 <meta name="viewport" content="width=device-width, initial-scale=1" />
8
 <meta name="viewport" content="width=device-width, initial-scale=1" />
9
 <title></title>
9
 <title></title>
246
 
246
 
247
 <center><h1>Developers Guide</h1></center>
247
 <center><h1>Developers Guide</h1></center>
248
 
248
 
249
-<div id="outline-container-org320decc" class="outline-2">
250
-<h2 id="org320decc">Introduction</h2>
251
-<div class="outline-text-2" id="text-org320decc">
249
+<div id="outline-container-orgeb19df0" class="outline-2">
250
+<h2 id="orgeb19df0">Introduction</h2>
251
+<div class="outline-text-2" id="text-orgeb19df0">
252
 <p>
252
 <p>
253
 Freedombone consists of a set of bash scripts. There are a lot of them, but they're not very complicated. If you're familiar with the GNU/Linux commandline and can hack a bash script then you can probably add a new app or fix a bug in the system. There are no trendy development frameworks to learn or to get in your way.
253
 Freedombone consists of a set of bash scripts. There are a lot of them, but they're not very complicated. If you're familiar with the GNU/Linux commandline and can hack a bash script then you can probably add a new app or fix a bug in the system. There are no trendy development frameworks to learn or to get in your way.
254
 </p>
254
 </p>
255
 </div>
255
 </div>
256
 </div>
256
 </div>
257
-<div id="outline-container-orgaee9f2d" class="outline-2">
258
-<h2 id="orgaee9f2d">Substitute for a Code of Conduct</h2>
259
-<div class="outline-text-2" id="text-orgaee9f2d">
257
+<div id="outline-container-org70ef738" class="outline-2">
258
+<h2 id="org70ef738">Substitute for a Code of Conduct</h2>
259
+<div class="outline-text-2" id="text-org70ef738">
260
 <p>
260
 <p>
261
 Instead of having some tedious <i>Code of Conduct</i> which tries to micro-manage how folks communicate privately with each other this project has a set of guiding principles, which are as follows:
261
 Instead of having some tedious <i>Code of Conduct</i> which tries to micro-manage how folks communicate privately with each other this project has a set of guiding principles, which are as follows:
262
 </p>
262
 </p>
264
 <ul class="org-ul">
264
 <ul class="org-ul">
265
 <li>Enable users to help themselves to provide their own personal software infrastructure.</li>
265
 <li>Enable users to help themselves to provide their own personal software infrastructure.</li>
266
 <li>Enable users to help each other to provide software infrastructure for a community.</li>
266
 <li>Enable users to help each other to provide software infrastructure for a community.</li>
267
+<li>Principle of self-management: apps should require miniumum configuration and maintain themselves as far as possible.</li>
267
 <li>There should be no single point of failure. Assume that other servers can and will fail occasionally.</li>
268
 <li>There should be no single point of failure. Assume that other servers can and will fail occasionally.</li>
268
 <li>Minimum data retention. Only store the data which users actually want or need, and within apps implement the function which allows logging to be turned off.</li>
269
 <li>Minimum data retention. Only store the data which users actually want or need, and within apps implement the function which allows logging to be turned off.</li>
269
 <li>Respect other users right to run their own stuff and have their own policies on their own hardware.</li>
270
 <li>Respect other users right to run their own stuff and have their own policies on their own hardware.</li>
274
 </div>
275
 </div>
275
 </div>
276
 </div>
276
 
277
 
277
-<div id="outline-container-org350cefa" class="outline-2">
278
-<h2 id="org350cefa">Adding extra apps</h2>
279
-<div class="outline-text-2" id="text-org350cefa">
278
+<div id="outline-container-orgce166ed" class="outline-2">
279
+<h2 id="orgce166ed">Adding extra apps</h2>
280
+<div class="outline-text-2" id="text-orgce166ed">
280
 <p>
281
 <p>
281
 Suppose you have some internet application which you want to add to the system. To do this you need to create an app script which tells the system how to install/remove and also backup/restore. The script should be designed to work with the current stable version of Debian.
282
 Suppose you have some internet application which you want to add to the system. To do this you need to create an app script which tells the system how to install/remove and also backup/restore. The script should be designed to work with the current stable version of Debian.
282
 </p>
283
 </p>
554
 </div>
555
 </div>
555
 </div>
556
 </div>
556
 
557
 
557
-<div id="outline-container-orgc1d1e00" class="outline-2">
558
-<h2 id="orgc1d1e00">Customising mesh images</h2>
559
-<div class="outline-text-2" id="text-orgc1d1e00">
558
+<div id="outline-container-org2e7b384" class="outline-2">
559
+<h2 id="org2e7b384">Customising mesh images</h2>
560
+<div class="outline-text-2" id="text-org2e7b384">
560
 <p>
561
 <p>
561
 If you want to make your own specially branded version of the mesh images, such as for a particular event, then to change the default desktop backgrounds edit the images within <b>img/backgrounds</b> and to change the available avatars and desktop icons edit the images within <b>img/avatars</b>. Re-create disk images using the instructions shown previously.
562
 If you want to make your own specially branded version of the mesh images, such as for a particular event, then to change the default desktop backgrounds edit the images within <b>img/backgrounds</b> and to change the available avatars and desktop icons edit the images within <b>img/avatars</b>. Re-create disk images using the instructions shown previously.
562
 </p>
563
 </p>