687
edits
Changes
Jump to navigation
Jump to search
Line 46:
Line 46: + + + + + + + + +
Platform Team/Package Management System/Getting started (view source)
Revision as of 18:51, 9 January 2012
, 18:51, 9 January 2012Explore further documentation
* make Sugar Shell launch as simply and obviously as possible for early adopters,
* 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).
* 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)