[Freedombox-discuss] Discussion: Problems with FreedomBox documentation

Joseph Nuthalapati njoseph at thoughtworks.com
Tue Oct 30 07:32:32 GMT 2018


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

Our documentation on the Debian wiki[1] currently has the
following problems:

1. Cannot keep pace with the development
2. Not written for a non-technical audience in mind
3. Has a high barrier to entry (account creation, wiki syntax,
unfamiliar UI) 4. No separate documentation for the stable and
testing/unstable versions of FreedomBox

Let's discuss and come up with some solutions. 

Some solutions that have already been proposed earlier are: 1.
Moving to a different wiki (or another format) that has a lower
barrier to entry. 2. Reaching out to some professional
documentation writers in the FOSS community.

Localization for FreedomBox has been going very well. The
documentation needs some love too.

Links:
1. https://wiki.debian.org/FreedomBox/

- -- 
- -- 
Regards
Joseph Nuthalapati

-----BEGIN PGP SIGNATURE-----

iQIzBAEBCgAdFiEE4rQIdbX3Xc6j+BCYU5jwCi+kPDUFAlvYCSEACgkQU5jwCi+k
PDWw0w//Yl+MEYN94rwoIVLgTfbjpkSgHD3dpg/3wqVo3t3qqgsp1bIdYpV/AOH3
lzXfECVQr0fWcAXLzwoVL5tSUEn215C4elyS8i5rF4lsu9xE+pLZ21lZNa+VNz5f
+VIhvrDNi00uKkUX8Vna8Z7iA7DrLQJqMCUhNOHLGFRlEfVlsShxTiP62sdpoQXM
IWiEj0ugi6ZLzzalK5NV0GEV+nClahfEcOdlfOB6VtMmHPmppYvct9vWofJ7JXC0
UuZEp86Fp67fuQVEKjFkWiyKJ3bNx/W0ZbqHFcocF2IXLzEuJMfPXAF7CxKtayib
AMHuKrU6E6kUmqxL695sBFNg8u2wmdv5rZR4RMcXT6BejbhZ3nyNpVv5UeUxxI8F
HOlXeLXbuBKXz/9cZmXi646IPWOXiciIHVYQ5N05cL0LadqNYuLezS/ksbiqX6XB
uolqFMkKKhY0EsDq2TQsVBF88c4OXbRxHZ9AA58lH7zC66UfmFlCAIksYH3cIvf1
ILahaR6nomct9Aq6uhSkWMLnYexqEuESMC4EI83rMrHKHmmZCJfGL6gbCUaHDX7m
UHQJ5AuVhxF0bTGTAirVj/AxIAvBhIupHQUl9jWNPD+K/GfpXLGHT6KNgO5PGhBt
VlRObuWbHH28kTLeweut5yrSuGQLIHOaufc2uN3Ec806bOWJjcc=
=pmJe
-----END PGP SIGNATURE-----


More information about the Freedombox-discuss mailing list