Platform Team/Package Management System/Getting started: Difference between revisions

← Older edit Newer edit →

@@ Line 46: / Line 46: @@
 * make Sugar Shell launch as simply and obviously as possible for early adopters,
 * add new entrance for non-doers, the way to run activities via Sweets (big task that requires special treatment).
+== Explore further documentation ==
+Based on my limited experience of installing sweets on only two distros, Mint-12 and Debian, testing, Wheezy I have two possible suggestions for improved documentation.
+# To write man sweets. I looked up man 0install and found it quite helpful. I liked the tone, style and layout. It seemed well balanced in delivering entry-level material at the start. Could a working start to man sweets be made by just replacing '0install' with 'sweets' in man 0install?
+# Worked example / human testing page. Aim to actually encourage non-tech users to try installing sweets. A set of instructions covering only download, install and test one variant of sweets on any distro, in the form of an entry-level worked example. The text would aim to demonstrate just a few commands, including use of a few diagnostic commands if known to work on a partially installed sweets project. Try to flag up the point where a less experienced user should file a help enquiry. Include - how to generate a 'log', 'request-help-enquiry', or Bug report in order to report any difficulties or ask for help.
+This approach would hope to encourage testing and exploration by less experienced users. How this page is flagged up to those users is a different matter.
+With an entry level 'install page' to support [[Platform_Team/Guide/Sugar_via_Sweets | Sugar via Sweets]], [[Platform_Team/Guide/Sweets_Usage | Sweets Usage]] could be more focused on covering usage once sweets was up and running. --[[User:Inkyfingers|Inkyfingers]] 17:51, 9 January 2012 (EST)