Discussion - https://help.ubuntu.com/community/PopularPages

[BlinkinCat]

Hi all,

Make your own comparison between NewDocs and TitleIndex.

TitleIndex here - https://help.ubuntu.com/community/TitleIndex

Newdocs here - https://help.ubuntu.com/community/NewDocs


TitleIndex :

Pros -

Holds the complete listing of Ubuntu Documentation.

Cons -

The intial loading of the list takes between 20 to 28 seconds.

The navigation of the pages is very awkward.

Alphabetical Pages do not lend themselves to convenient printouts.

With a list in excess of 4,000 practicable adjustments are difficult.



NewDocs :

Pros -

Loads in 4 to 5 seconds.

Returns between 85 - 90 Percent of Ubuntu Documentation Searches.

May be conveniently Bookmarked - Reducing pages from hundreds to one.

TitleIndex may be used in the event that a page isn't found.(link on facepage)

The navigation of the pages is convenient.

Alphabetical pages may be easily printed out for referral purposes.

Response from many end users has been positive - see Post #23
http://ubuntuforums.org/showpost.php...8&postcount=23

Cons -

None.


By all means have a "play" with NewDocs and see how easy it is to use. Have a look at page A2 too. As I have indicated, many end-users have expressed their confirmation in it's value.

Having being involved with the NewDocs Wiki from the beginning, I am now anxious to have other people contribute.

The major problem as I see it, is how best to move forward with NewDocs, so that it is available to and used by the largest number of Ubuntu end-users practicable. I consider the NewDocs Wiki virtually complete now, the problem being with it's marketing.

You may see the problem in a different light.

I seek advice and help from others. If you have a comment of any nature or a contribution, kindly post on this thread. I will certainly be very pleased to hear from you.

With kind regards,
BlinkinCat -

[BlinkinCat]

Hi all,

Today I created a Monthly Update Page for an explanation of the Monthly Updating Methods.

View it here - https://help.ubuntu.com/community/MonthlyUpdates

As an introduction to the page I added a line to the "Alterations" Page.

View the "Alterations" Page here - https://help.ubuntu.com/community/AlterationsToNewDocs

There remains only three days until the Monthly Updating on 01/03/13.

To this stage there are fifteen new Documentation Pages with one of these to be entered twice. (Making a total of sixteen additions)

The total number of Documentation Pages in the NewDocs list at that stage will be 695.

At the time of the updates on the 1st March, I will also be undertaking some tidying up, which I believe will ensure that NewDocs will be close to the best that I can make it.

With kind regards,
BlinkinCat -

EDIT: The suggestions made in this post have since been revised.

[BlinkinCat]

Hi all,

Today I performed what I believe will be the last Monthly update to NewDocs.

From now on I will allow myself two days to do the updating of any new pages that are to be listed.

Today's update included the addition of 13 pages, 2 of which had double entries, and 1 removed page.
There are now 693 page entries in NewDocs.

I rewrote the Alterations Page -
https://help.ubuntu.com/community/AlterationsToNewDocs

The case for 48 hour Updating is shown here -
https://help.ubuntu.com/community/48HourUpdating

The complete NewDocs link -
https://help.ubuntu.com/community/NewDocs

Cheers,
BlinkinCat -

EDIT: The suggestions made in this post have since been revised.

[BlinkinCat]

Hi all,

Firstly I have created a new page called "Links" -
This page contains links that may be of value to users of NewDocs.
I have also included two Podcasts in this page following a suggestion by matt_symes.
https://help.ubuntu.com/community/Links

I have also rewitten the "Alterations" Page to suit -
This included removing some excess sentences.
https://help.ubuntu.com/community/AlterationsToNewDocs

The 48 Hour Updating Page has also been changed - I removed reference to Monthly Updates -
https://help.ubuntu.com/community/48HourUpdating

I consider that now NewDocs is very close to a peak in it's development. At this stage I see little room for improvement.

Of course the complete version of NewDocs can be viewed in my signature at any time.

With kind regards,
BlinkinCat -

EDIT: 48 Hour updating no longer applies.

[tgalati4]

Going forward, using the 80/20 rule may be helpful in maintaining NewDocs. Once a month, review the statistics of hits on NewDocs pages. Summarize and post the top 20% (of total hits), or just publish the top 10 pages that get hits in NewDocs. Compare this top 10 to the total community documentation top 10 to make sure we have those pages. Any new pages that show up in the overall top 10, but not in NewDocs could then get pulled into NewDocs. With this monthly posting, ask the community to review 1 or 2 of the top 10 pages for errors/clarifications, and that will focus the community efforts to clean up pages that get frequently accessed. Over time, the "hot" pages will get reviewed more frequently, as that is what the community is using as a help resource. The monthly publishing of the active list will act as a bump for the post and keep the community involved.

It took about an hour to pull in the statistics from the Community Documentation, put them in a spreadsheet, then rank order them, take the top 20% of hits, and post the results. It would be nice to have a more automated process. Perhaps there are some tools within the documentation wiki to do this already, I don't know.

Perhaps someone could write a script to query the NewDocs tree for "Last Edited" greater than 2 months as a bubble up for documentation that could use review. It would be really trick to put the Top 10 documents (links) automatically in your signature once a month.

[BlinkinCat]

Hi all,

The Monthly Updates for NewDocs for the First of March 2013 included some interesting additions.

Firstly, "Get Lubuntu" entered the Top Ten Page Hits in position Five.


Additions :

Having looked over the TitleIndex listing, I had noticed that there were 36 entries associated with "Forum". Wishing to come up with a more relevant group, I approached nothingspecial to see if there were any additions in his view that should be listed in NewDocs from the "Forum" group. He came up with four pages.

They are :

Forum Council

Ubuntu Forums (listed twice)

Forums / Membership

Forum_Staff (As yet incomplete but will be interesting to observe)



I added the following :

Ubuntu Home (listed twice)

Basic Security

DemystifyingUnityGraphicsHardwareRequirements

Error Tracker

Lubuntu / Get Lubuntu

Mobile Wireless Broadband

Quickly

Unanswered Posts Team / Solved Threads (Being observed)

Uncomplicated Firewall



Removed Page : Radeon HD



Top Ten Page Hits Over Past Month :

1. Installation / From USB Stick

2. Grub2

3. Using The Terminal

4. Java

5. Lubuntu / Get Lubuntu

6. Apache My SQL PHP

7. Windows Dual Boot

8. Root Sudo

9. Boot-Repair

10. Burning Iso Howto


How You Can Help :

There are dozens of pages on the TitleIndex list that simply shouldn't be there. There may be some on the NewDocs list too. The correct and helpful approach in dealing with obsolete pages is the addition of tags. Read about tags here -
https://help.ubuntu.com/community/Tag
One clue to checking for obsolete pages is by checking the last edit date (generally on the lower right corner of page)




I would like to acknowledge the continued support of NewDocs by tgalati4


With kind regards,
BlinkinCat -

[BlinkinCat]

Eliminating the NewDocs numbering system has provided a welcome sleekness.

It was not intended to post so soon but I wished to announce several changes publicly.

The original method of numbering listed pages was ugly and in the end impractical. Wiki edits were awkward and time consuming. Bypassing the numbers system makes amendments far easier to conclude. The added bonus is the much improved appearance of NewDocs.

Additionally, I have added eleven pages to the NewDocs list as well as updating two others. The pages are -

Documentation For Ubuntu 12.04 LTS

Laptop Lid And Dock Scripts

Lubuntu / Documentation / Remove Lubuntu Desktop (Updated)

Mutt And Gmail

Support

Ubuntu Desktop 12.04.2

Ubuntu Desktop Guide

Ubuntu Pastebin

What is Unity ? (Listed twice)

What's New ?

Windows Dual Boot (Updated)

Xubuntu

Xubuntu 12.04



The current number of pages in the NewDocs List is 704 with an additional 67 Links.




I also wish to thank MG&TL for his recent edit to NewDocs.


With kind regards,
BlinkinCat -

[meteorrock]

I think this wiki is a good idea <blinkingcat>. Been looking for newer documentation for the little used commands in the terminal like the <aufs> commands and the <grub> commands. Most information on this is outdated on the internet. Most of the documentation I had to find on <stackoverflow.com> and for the mid to lower grade developer that site is a tad overwhelming. I had to research different linux and development sites for weeks just for learning path variables and switches used with commands through different linux archives on the internet.

Some instructions I had to dig bit by bit through archived forums. While you can find this information on checking out books from the library, or in student books for those in computer development looking into a degree in that field, I feel these instructions should be available all in one site online for research purposes. To me it just seems like a secret art you have to spend TONS of time into surfing all over the internet.

I see in the forums here questions on patch commands and the switches used for them, from even the most dedicated posters here. While there are tools now to do some of this for linux and android, you must learn the basics on these tools if you have trouble compiling your projects. Younger developers like myself are not taught these skills even in the advanced computer classes in high school. And most will not suffer the time and dedication on constant searching with varied key words inputted into the google search bar.

Most of the old school coders uphold these standards because they want to keep "cowboy" coders out of their projects. I feel on some projects this should be encouraged, small projects using linux kernels , for example older android devices for rooting and development.

Good luck. I will keep an eye on this site you are developing.

[tgalati4]

There is no right way to learn linux. I treat it like a cave explorer game. You go down little paths, into dark caves of unknown. You turn on your little torch and you ask questions until you are eaten by a golem. Then you magically reappear in another part of the cave.

But always find something that you are interested in and research it and keep at it. After 10 years, you will be somewhat good at it. I find that answering questions on the forums is a learning experience. I do it for the challenge. I really don't care if I help people. Someone throws out a question and it becomes a personal challenge to answer it. It's a disease, like collecting old newspapers.

[BlinkinCat]

NewDocs list reaches 802 mark with the addition of 98 more pages.

Other than when the list was first created, this is the largest single addition to the database. The extra pages were obtained via manual perusal of the "page hits" list. I will be obtaining further pages in the weeks ahead with the aim to making NewDocs even more efficient that it is today. However I don't anticipate that future single additions will be as large as this one.

Rather than produce a complete list of the new pages, the list here is from the alphabetical page "U" which produced the largest number of input at 17 pages.

Ubuntu as Guest OS

Ubuntu LTSP / iTalc

Ubuntu LTSP / Proxy DHCP

Ubuntu LTSP / Thin Client How to NAT

Ubuntu OEM Installer Overview

ubuntu preciseon 2011 imac

ubuntu precisequantalon 2011 imac

Ubuntu Pre-installed

Ubuntu Science / Alternatives To Proprietary Software

Ubuntu Science / Astronomy

Ubuntu Studio / How Tos

Ubuntu Studio / Installing Ubuntu Studio

Ubuntu Studio / Pro Audio Intro / 1204

Ubuntu Studio / Resources

Ubuntu Studio / Supported Hardware

UNetbootin

Unity-Replace Dodge Windows Behavior

Invariably, whenever I have compiled a new group of pages to add to the NewDocs list, there are one or two that appear to be obvious choices that I shouldn't have previously missed. Of those listed above UNetbootin is one example that should have been in NewDocs before now.

Therefore I appeal to readers of this post to assist whenever they come across a page that should be in NewDocs and isn't, (check it out first of course) if you could let me know by contacting me via pm and Add The Link To The New Page Here it would be greatly appreciated and a benefit to all.

With kind regards,
BlinkinCat -