Create User Manuals

From Openmoko

(Difference between revisions)
Jump to: navigation, search
m
 
(5 intermediate revisions by 5 users not shown)
Line 1: Line 1:
Openmoko is a project driven by a community of passionate volunteers. This includes the implementation, testing and improving of the open source code on the one side. On the other side any software is created for the benefit of users and these users are normally not developers. User Maunals like the [[SHR User Manual]] helps people, who are not involved the coding part of the project to use the distributions and applications on the freerunner. User Manuals make it easier for them to get started. Involving people that are not developers could be of benefit for the developers to keep usability in mind so that feedback will be possible for the non-developers at early developing stages. If you are not a developer you have certainly the ability to share, your problems especially with GUIs (Graphical User Interfaces) and discriptions of workflows in installations procedures. Your contributions are extremly welcome to improve the User Manuals itself and in the long run having influence on the software itself.  
+
{{Languages|Create User Manuals}}
 +
Openmoko is a project driven by a community of passionate volunteers. This includes the implementation, testing and improving of the open source code on one side. On the other side any software is created for the benefit of users and these users are normally not developers. User Maunals like the [[SHR User Manual]] help people, who are not involved the coding part of the project. They just want to use the distributions and applications on the freerunner with some of the available [[Distributions]]. User [[Manuals]] make it easier for them to get started. Involving people that are not developers could be of benefit for the developers to keep usability in mind, so that feedback will be possible for the non-developers at early developing stages. If you are not a developer you have certainly the ability to share, your problems especially with GUIs (Graphical User Interfaces) and discriptions of workflows in installations procedures. Your contributions are extremly welcome to improve the User Manuals itself and in the long run having influence on the software itself.  
  
 
Openmoko's ambitions far exceed the resources available, so your contributions as a non developer could be:
 
Openmoko's ambitions far exceed the resources available, so your contributions as a non developer could be:
* '''Improve existing User Manuals''' like [[SHR User Manual]], when you install the e.g. SHR for the first time and configure SHR on your OpenMoko with the help of the user manual, mention problems with the manual according to your personal installation procedure and if your solved the problem document your solution in this wiki or add a link that . differences in the way.
+
* '''Improve existing User Manuals''' like [[SHR User Manual]], when you install the e.g. SHR for the first time and configure SHR on your OpenMoko with the help of the user manual, mention problems with the manual according to your personal installation procedure and if your solved the problem document your solution in this wiki or add a link that shows a solution or workaraound for the problem.
* '''Create a new user manual''' e.g. for [[OM2009 User Manual]]
+
* '''Add screenshots''' to the manual at the explainations when images can say more than 1000 words and make it easier for other users to follow the procedure. You can make screenshots on many distributions with  
* '''Add screenshots''' to the manual at the explaintions when images can say more than 1000 words and make it easier for other users to follow the procedure. You can make screenshots on many distributions with  
+
 
** e.g. [[gpe-scap]] which you can install on your FreeRunner, if it is not installed on you system.  
 
** e.g. [[gpe-scap]] which you can install on your FreeRunner, if it is not installed on you system.  
** Download the screenshots from you freerunner with scp or sftp from your desktop computer
+
** Download the screenshots from you freerunner with scp or sftp from your desktop computer.
** Create a link for images in the wiki edit mode (press ''edit'' in the manual and look for this text in the manual, there you find the link for embedded images) [[Image:Example123.jpg]]. You can click on the link and upload the image to the wiki.
+
** Create a link for images in the wiki edit mode (press ''edit'' in the manual and look for this text in the manual, there you find the link for embedded images) [[Image:Example123.jpg]].  
 +
** In the edit mode of this page the link looks like this <pre>[[Image:Example123.jpg]]</pre> You can click on the link and upload the image to the wiki.
 
** You can replace images by new ones due to change in graphical user interfaces. The wiki keep track of older versions and replacing an image will not overwrite it.
 
** You can replace images by new ones due to change in graphical user interfaces. The wiki keep track of older versions and replacing an image will not overwrite it.
  

Latest revision as of 09:25, 26 November 2010

Openmoko is a project driven by a community of passionate volunteers. This includes the implementation, testing and improving of the open source code on one side. On the other side any software is created for the benefit of users and these users are normally not developers. User Maunals like the SHR User Manual help people, who are not involved the coding part of the project. They just want to use the distributions and applications on the freerunner with some of the available Distributions. User Manuals make it easier for them to get started. Involving people that are not developers could be of benefit for the developers to keep usability in mind, so that feedback will be possible for the non-developers at early developing stages. If you are not a developer you have certainly the ability to share, your problems especially with GUIs (Graphical User Interfaces) and discriptions of workflows in installations procedures. Your contributions are extremly welcome to improve the User Manuals itself and in the long run having influence on the software itself.

Openmoko's ambitions far exceed the resources available, so your contributions as a non developer could be:

  • Improve existing User Manuals like SHR User Manual, when you install the e.g. SHR for the first time and configure SHR on your OpenMoko with the help of the user manual, mention problems with the manual according to your personal installation procedure and if your solved the problem document your solution in this wiki or add a link that shows a solution or workaraound for the problem.
  • Add screenshots to the manual at the explainations when images can say more than 1000 words and make it easier for other users to follow the procedure. You can make screenshots on many distributions with
    • e.g. gpe-scap which you can install on your FreeRunner, if it is not installed on you system.
    • Download the screenshots from you freerunner with scp or sftp from your desktop computer.
    • Create a link for images in the wiki edit mode (press edit in the manual and look for this text in the manual, there you find the link for embedded images) File:Example123.jpg.
    • In the edit mode of this page the link looks like this
      [[Image:Example123.jpg]]
      You can click on the link and upload the image to the wiki.
    • You can replace images by new ones due to change in graphical user interfaces. The wiki keep track of older versions and replacing an image will not overwrite it.

Remark: Please do not upload images to Example123.jpg here on this page, so that people can see the results of just inserting an image tag in wiki text without uploading.

Note:register as a wiki user by creating an account in the wiki system when want you upload images. Please read the Openmoko Wiki Editing Guidelines before changing a manual.

Personal tools

Openmoko is a project driven by a community of passionate volunteers. This includes the implementation, testing and improving of the open source code on the one side. On the other side any software is created for the benefit of users and these users are normally not developers. User Maunals like the SHR User Manual helps people, who are not involved the coding part of the project to use the distributions and applications on the freerunner. User Manuals make it easier for them to get started. Involving people that are not developers could be of benefit for the developers to keep usability in mind so that feedback will be possible for the non-developers at early developing stages. If you are not a developer you have certainly the ability to share, your problems especially with GUIs (Graphical User Interfaces) and discriptions of workflows in installations procedures. Your contributions are extremly welcome to improve the User Manuals itself and in the long run having influence on the software itself.

Openmoko's ambitions far exceed the resources available, so your contributions as a non developer could be:

  • Improve existing User Manuals like SHR User Manual, when you install the e.g. SHR for the first time and configure SHR on your OpenMoko with the help of the user manual, mention problems with the manual according to your personal installation procedure and if your solved the problem document your solution in this wiki or add a link that . differences in the way.
  • Create a new user manual e.g. for OM2009 User Manual
  • Add screenshots to the manual at the explaintions when images can say more than 1000 words and make it easier for other users to follow the procedure. You can make screenshots on many distributions with
    • e.g. gpe-scap which you can install on your FreeRunner, if it is not installed on you system.
    • Download the screenshots from you freerunner with scp or sftp from your desktop computer
    • Create a link for images in the wiki edit mode (press edit in the manual and look for this text in the manual, there you find the link for embedded images) File:Example123.jpg. You can click on the link and upload the image to the wiki.
    • You can replace images by new ones due to change in graphical user interfaces. The wiki keep track of older versions and replacing an image will not overwrite it.

Remark: Please do not upload images to Example123.jpg here on this page, so that people can see the results of just inserting an image tag in wiki text without uploading.

Note:register as a wiki user by creating an account in the wiki system when want you upload images. Please read the Openmoko Wiki Editing Guidelines before changing a manual.