diff --git a/doc/EN/devguide.org b/doc/EN/devguide.org index 9dca75c2..0f9acede 100644 --- a/doc/EN/devguide.org +++ b/doc/EN/devguide.org @@ -14,6 +14,16 @@

Developers Guide

#+end_export +* Introduction +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. +* Community Statement +This project doesn't require you to take any special pledge of allegiance or subscribe to any guru's list of commandments. It does not care about your gender, race, national flag or political alignment. It is agnostic towards your religion or lack thereof. It doesn't give one hoot as to whether you are young or old, rich or poor, gay, trans or straight. It does not care if you like your eggs sunny side up or if you are a vegan. + +This is an inclusive project which will take patches or pull requests from anyone, in a generous manner along the lines described by the late Pieter Hintjens in his book /Social Architecture/. Any useful patch is likely to be merged so long as it is submitted under a license compatible with AGPL3. + +Freedombone is a free system. That's free as in no secret source. For anything. Although there's nothing to stop you from adding proprietary utilities or apps if you wish, any patches containing closed stuff or which are dependent upon closed stuff won't be accepted. + +This project also has a no bullshit policy. Anyone trying to cause a ruckus by trolling or engaging in behavior which is disruptive or disrespectful to others will be speedily blocked and ignored. Life's too short, and there's too much to be done. * Adding extra apps 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. @@ -252,3 +262,8 @@ control Select *Add/Remove Apps* and if all is well then you should see your app listed as installable. Test that installing and removing it works as expected. Submit your working app to *https://github.com/bashrc/freedombone/issues* + +* Customising mesh images +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 *img/backgrounds* and to change the available avatars and desktop icons edit the images within *img/avatars*. Re-create disk images using the instructions shown previously. + +If you need particular /dconf/ commands to alter desktop appearance or behavior then see the function /mesh_client_startup_applications/ within *src/freedombone-image-customise*. diff --git a/website/EN/devguide.html b/website/EN/devguide.html index 14a32e96..ed0bbdec 100644 --- a/website/EN/devguide.html +++ b/website/EN/devguide.html @@ -3,7 +3,7 @@ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> - + @@ -245,9 +245,37 @@ for the JavaScript code in this tag.

Developers Guide

-
-

Adding extra apps

-
+
+

Introduction

+
+

+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. +

+
+
+
+

Community Statement

+
+

+This project doesn't require you to take any special pledge of allegiance or subscribe to any guru's list of commandments. It does not care about your gender, race, national flag or political alignment. It is agnostic towards your religion or lack thereof. It doesn't give one hoot as to whether you are young or old, rich or poor, gay, trans or straight. It does not care if you like your eggs sunny side up or if you are a vegan. +

+ +

+This is an inclusive project which will take patches or pull requests from anyone, in a generous manner along the lines described by the late Pieter Hintjens in his book Social Architecture. Any useful patch is likely to be merged so long as it is submitted under a license compatible with AGPL3. +

+ +

+Freedombone is a free system. That's free as in no secret source. For anything. Although there's nothing to stop you from adding proprietary utilities or apps if you wish, any patches containing closed stuff or which are dependent upon closed stuff won't be accepted. +

+ +

+This project also has a no bullshit policy. Anyone trying to cause a ruckus by trolling or engaging in behavior which is disruptive or disrespectful to others will be speedily blocked and ignored. Life's too short, and there's too much to be done. +

+
+
+