Results 1 to 7 of 7

Thread: Writing a manual

  1. #1
    Join Date
    Oct 2013
    Beans
    334
    Distro
    Xubuntu 14.10 Utopic Unicorn

    Writing a manual

    I am writing a manual on how to make an extremely lightweight and fast Ubuntu installation.

    I am almost complete with the manual, but I feel like it needs more.

    What are some common things that Ubuntu tutorials miss or aren't very clear on?

    Also, what are some things I should avoid in this manual?
    Things to remember :
    - Use proper english
    - Comment your code
    - Keep background information and introductions to a minimum

  2. #2
    Join Date
    Feb 2010
    Location
    Summerwind
    Beans
    11,235
    Distro
    Ubuntu 16.04 Xenial Xerus

    Re: Writing a manual

    See the links for forum tutorial guidelines and Wiki Guide. I think any method should be tested with more than one computer . There are many guides/tutorials posted on line and many offer no plan of action if things go wrong. Installation guides need to updated as necessary for new releases.

    http://ubuntuforums.org/showthread.php?t=2143602

    https://help.ubuntu.com/community/WikiGuide
    “ Diversity: The art of thinking independently together ”

    Ubuntu Documentation Search: Popular Pages
    Ubuntu: Security Basics
    Ubuntu: Manual

  3. #3
    Join Date
    Oct 2013
    Beans
    334
    Distro
    Xubuntu 14.10 Utopic Unicorn

    Re: Writing a manual

    Thanks. I did add contact information for if things go wrong. Mainly because I can't think of any situation where things would go wrong in most of the steps.

    Also, I only have one computer. Is there a way I could get other people to help test it and give me feedback?
    Things to remember :
    - Use proper english
    - Comment your code
    - Keep background information and introductions to a minimum

  4. #4
    Join Date
    Feb 2007
    Location
    West Hills CA
    Beans
    10,050
    Distro
    Ubuntu 14.04 Trusty Tahr

    Re: Writing a manual

    Go through the top links in community documentation and see what is missing or what needs clarification.
    -------------------------------------
    Oooh Shiny: PopularPages

    Unumquodque potest reparantur. Patientia sit virtus.

  5. #5
    Join Date
    May 2007
    Location
    The New Forest
    Beans
    Hidden!
    Distro
    Xubuntu

    Re: Writing a manual

    Thread moved to Ubuntu, Linux and OS Chat.

  6. #6
    Join Date
    Jun 2013
    Beans
    17

    Re: Writing a manual

    Quote Originally Posted by Tristan_Williams View Post
    I am writing a manual on how to make an extremely lightweight and fast Ubuntu installation.
    If it doesn't include Ubuntu minimal CD, then you already missed the mark.

  7. #7
    Join Date
    Oct 2013
    Beans
    334
    Distro
    Xubuntu 14.10 Utopic Unicorn

    Re: Writing a manual

    Quote Originally Posted by dbass81 View Post
    If it doesn't include Ubuntu minimal CD, then you already missed the mark.
    Actually yes, it does start with the minimal cd
    I would never ever ever install ubuntu any other way never!!!
    Things to remember :
    - Use proper english
    - Comment your code
    - Keep background information and introductions to a minimum

Bookmarks

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts
  •