organizing manuals on the wiki

classic Classic list List threaded Threaded
12 messages Options
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

organizing manuals on the wiki

Marko Knöbl-2
Hi!

Because of the recent efforts of creating a manual for SHR I have
looked through the wiki and I have found that there are already
several pages that could be seen as manuals for some distributions.
However these are totally unstructured. Therefore I'd like to have
some kind of standardisation about where the manuals should be put.

For example Om 2008: I've found these pages which describe parts of Om 2008:
"Getting Started with your Neo ReeRunner", "Om 2008 guide", "Om 2008
Sudoku", "Om 2008 keyboard", "Om 2008 Installer" and "Om 2008
locations". These pages are only loosely connected and hard to find.

Therefore I would like to organize these manuals so information can be
found more easily and they can be maintained better.

My plan would be to separate device-specific information from
distribution-specific information. So I'd propose to have
device-manuals and distribution-manuals.

Device-manuals could be written for Neo FreeRunner, Neo 1973 and
probably E-TEN M 800 (SHR semms to work on this device). They would
contain information about buttons and connectors, opening devices,
inserting SIM/memory card, updating bootloader and GSM-firmware. The
first sections of the page "Getting Started with your Neo FreeRunner"
would be a good starting point for these pages.

Distribution manuals would be manuals about certain distributions and
basic applications of these distributions, no matter on what hardware
they are installed.

What do you think? Is this a good idea?

_______________________________________________
documentation mailing list
[hidden email]
https://lists.openmoko.org/mailman/listinfo/documentation
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: organizing manuals on the wiki

Marko Knöbl-2
2009/7/22, Marko Knöbl <[hidden email]>:

> Hi!
>
> Because of the recent efforts of creating a manual for SHR I have
> looked through the wiki and I have found that there are already
> several pages that could be seen as manuals for some distributions.
> However these are totally unstructured. Therefore I'd like to have
> some kind of standardisation about where the manuals should be put.
>
> For example Om 2008: I've found these pages which describe parts of Om
> 2008:
> "Getting Started with your Neo ReeRunner", "Om 2008 guide", "Om 2008
> Sudoku", "Om 2008 keyboard", "Om 2008 Installer" and "Om 2008
> locations". These pages are only loosely connected and hard to find.
>
> Therefore I would like to organize these manuals so information can be
> found more easily and they can be maintained better.
>
> My plan would be to separate device-specific information from
> distribution-specific information. So I'd propose to have
> device-manuals and distribution-manuals.
>
> Device-manuals could be written for Neo FreeRunner, Neo 1973 and
> probably E-TEN M 800 (SHR semms to work on this device). They would
> contain information about buttons and connectors, opening devices,
> inserting SIM/memory card, updating bootloader and GSM-firmware. The
> first sections of the page "Getting Started with your Neo FreeRunner"
> would be a good starting point for these pages.
>
> Distribution manuals would be manuals about certain distributions and
> basic applications of these distributions, no matter on what hardware
> they are installed.
>
> What do you think? Is this a good idea?
>
I've just have a deeper look into the existing pages of the wiki and
found the page "User's Manual" which is similar to what I had thought
of. Unfortunately this page never received much attention.
I think we could use this page as a starting point for the manuals.
However, as I've said before, I'd like to create one manual for each
distribution, and not one big manual where we put everything.
What I like about the concept of the existing manual is the structure
of the pages: There's one overwiew page called "User's Manual" and
several subpages labelled "User's Manual/Om 2008.8 Guide", "User's
Manual/Dialer", "User's Manual/Contacts",...
I think we could keep this concept and create "User's Manuals/Neo
FreeRunner", "User's Manuals/Neo 1973", "User's Manuals/SHR", ...
I think I'll start this transition in the next couple of days when I
have the time for it.

_______________________________________________
documentation mailing list
[hidden email]
https://lists.openmoko.org/mailman/listinfo/documentation
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: organizing manuals on the wiki

Marko Knöbl-2
2009/7/22, Marko Knöbl <[hidden email]>:

> 2009/7/22, Marko Knöbl <[hidden email]>:
>> Hi!
>>
>> Because of the recent efforts of creating a manual for SHR I have
>> looked through the wiki and I have found that there are already
>> several pages that could be seen as manuals for some distributions.
>> However these are totally unstructured. Therefore I'd like to have
>> some kind of standardisation about where the manuals should be put.
>>
>> For example Om 2008: I've found these pages which describe parts of Om
>> 2008:
>> "Getting Started with your Neo ReeRunner", "Om 2008 guide", "Om 2008
>> Sudoku", "Om 2008 keyboard", "Om 2008 Installer" and "Om 2008
>> locations". These pages are only loosely connected and hard to find.
>>
>> Therefore I would like to organize these manuals so information can be
>> found more easily and they can be maintained better.
>>
>> My plan would be to separate device-specific information from
>> distribution-specific information. So I'd propose to have
>> device-manuals and distribution-manuals.
>>
>> Device-manuals could be written for Neo FreeRunner, Neo 1973 and
>> probably E-TEN M 800 (SHR semms to work on this device). They would
>> contain information about buttons and connectors, opening devices,
>> inserting SIM/memory card, updating bootloader and GSM-firmware. The
>> first sections of the page "Getting Started with your Neo FreeRunner"
>> would be a good starting point for these pages.
>>
>> Distribution manuals would be manuals about certain distributions and
>> basic applications of these distributions, no matter on what hardware
>> they are installed.
>>
>> What do you think? Is this a good idea?
>>
> I've just have a deeper look into the existing pages of the wiki and
> found the page "User's Manual" which is similar to what I had thought
> of. Unfortunately this page never received much attention.
> I think we could use this page as a starting point for the manuals.
> However, as I've said before, I'd like to create one manual for each
> distribution, and not one big manual where we put everything.
> What I like about the concept of the existing manual is the structure
> of the pages: There's one overwiew page called "User's Manual" and
> several subpages labelled "User's Manual/Om 2008.8 Guide", "User's
> Manual/Dialer", "User's Manual/Contacts",...
> I think we could keep this concept and create "User's Manuals/Neo
> FreeRunner", "User's Manuals/Neo 1973", "User's Manuals/SHR", ...
> I think I'll start this transition in the next couple of days when I
> have the time for it.
>
I finished the first phase of restructuring for the manuals on Neo
1973, Neo FreeRunner, Om 2007.2 and Om 2008. The new manuals are
available at
http://wiki.openmoko.org/wiki/Manuals
The next question is: how do we link to these manuals? I'd propose to
replace the "Getting Started" link in the navigation box which is
linking to the obsolete page "Getting started with your Neo
FreeRunner" - I think we should replace that link with a link to
"Manuals" - Is that okay?

_______________________________________________
documentation mailing list
[hidden email]
https://lists.openmoko.org/mailman/listinfo/documentation
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: organizing manuals on the wiki

Marko Knöbl-2
2009/8/4, Marko Knöbl <[hidden email]>:

> 2009/7/22, Marko Knöbl <[hidden email]>:
>> 2009/7/22, Marko Knöbl <[hidden email]>:
>>> Hi!
>>>
>>> Because of the recent efforts of creating a manual for SHR I have
>>> looked through the wiki and I have found that there are already
>>> several pages that could be seen as manuals for some distributions.
>>> However these are totally unstructured. Therefore I'd like to have
>>> some kind of standardisation about where the manuals should be put.
>>>
>>> For example Om 2008: I've found these pages which describe parts of Om
>>> 2008:
>>> "Getting Started with your Neo ReeRunner", "Om 2008 guide", "Om 2008
>>> Sudoku", "Om 2008 keyboard", "Om 2008 Installer" and "Om 2008
>>> locations". These pages are only loosely connected and hard to find.
>>>
>>> Therefore I would like to organize these manuals so information can be
>>> found more easily and they can be maintained better.
>>>
>>> My plan would be to separate device-specific information from
>>> distribution-specific information. So I'd propose to have
>>> device-manuals and distribution-manuals.
>>>
>>> Device-manuals could be written for Neo FreeRunner, Neo 1973 and
>>> probably E-TEN M 800 (SHR semms to work on this device). They would
>>> contain information about buttons and connectors, opening devices,
>>> inserting SIM/memory card, updating bootloader and GSM-firmware. The
>>> first sections of the page "Getting Started with your Neo FreeRunner"
>>> would be a good starting point for these pages.
>>>
>>> Distribution manuals would be manuals about certain distributions and
>>> basic applications of these distributions, no matter on what hardware
>>> they are installed.
>>>
>>> What do you think? Is this a good idea?
>>>
>> I've just have a deeper look into the existing pages of the wiki and
>> found the page "User's Manual" which is similar to what I had thought
>> of. Unfortunately this page never received much attention.
>> I think we could use this page as a starting point for the manuals.
>> However, as I've said before, I'd like to create one manual for each
>> distribution, and not one big manual where we put everything.
>> What I like about the concept of the existing manual is the structure
>> of the pages: There's one overwiew page called "User's Manual" and
>> several subpages labelled "User's Manual/Om 2008.8 Guide", "User's
>> Manual/Dialer", "User's Manual/Contacts",...
>> I think we could keep this concept and create "User's Manuals/Neo
>> FreeRunner", "User's Manuals/Neo 1973", "User's Manuals/SHR", ...
>> I think I'll start this transition in the next couple of days when I
>> have the time for it.
>>
> I finished the first phase of restructuring for the manuals on Neo
> 1973, Neo FreeRunner, Om 2007.2 and Om 2008. The new manuals are
> available at
> http://wiki.openmoko.org/wiki/Manuals
> The next question is: how do we link to these manuals? I'd propose to
> replace the "Getting Started" link in the navigation box which is
> linking to the obsolete page "Getting started with your Neo
> FreeRunner" - I think we should replace that link with a link to
> "Manuals" - Is that okay?
>
No replies again ... It's getting a little boring on this list! :-)
As nobody is opposing I think this can be changed as I suggested. Can
one of the sysops (Brenda?) change this? (Replacing "Getting Started"
link on the left with a link to "Manuals"?)

_______________________________________________
documentation mailing list
[hidden email]
https://lists.openmoko.org/mailman/listinfo/documentation
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: organizing manuals on the wiki

Petr Vanek

>> I finished the first phase of restructuring for the manuals on Neo
>> 1973, Neo FreeRunner, Om 2007.2 and Om 2008. The new manuals are
>> available at
>> http://wiki.openmoko.org/wiki/Manuals
>> The next question is: how do we link to these manuals? I'd propose to
>> replace the "Getting Started" link in the navigation box which is
>> linking to the obsolete page "Getting started with your Neo
>> FreeRunner" - I think we should replace that link with a link to
>> "Manuals" - Is that okay?
>>
>No replies again ... It's getting a little boring on this list! :-)
>As nobody is opposing I think this can be changed as I suggested. Can
>one of the sysops (Brenda?) change this? (Replacing "Getting Started"
>link on the left with a link to "Manuals"?)

afaik very few people has stayed onboard of openmoko, there should be
list of people who still do have access to change things if needed.
Brenda is gone and i don't see a difference of her having the access or
Marko having it... what can we do to change this? get a list of people
and extend it somehow?

Petr


_______________________________________________
documentation mailing list
[hidden email]
https://lists.openmoko.org/mailman/listinfo/documentation
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: organizing manuals on the wiki

Marko Knöbl-2
2009/8/8, Petr Vanek <[hidden email]>:

>
>>> I finished the first phase of restructuring for the manuals on Neo
>>> 1973, Neo FreeRunner, Om 2007.2 and Om 2008. The new manuals are
>>> available at
>>> http://wiki.openmoko.org/wiki/Manuals
>>> The next question is: how do we link to these manuals? I'd propose to
>>> replace the "Getting Started" link in the navigation box which is
>>> linking to the obsolete page "Getting started with your Neo
>>> FreeRunner" - I think we should replace that link with a link to
>>> "Manuals" - Is that okay?
>>>
>>No replies again ... It's getting a little boring on this list! :-)
>>As nobody is opposing I think this can be changed as I suggested. Can
>>one of the sysops (Brenda?) change this? (Replacing "Getting Started"
>>link on the left with a link to "Manuals"?)
>
> afaik very few people has stayed onboard of openmoko, there should be
> list of people who still do have access to change things if needed.
> Brenda is gone and i don't see a difference of her having the access or
> Marko having it... what can we do to change this? get a list of people
> and extend it somehow?
>
> Petr
>
>
> _______________________________________________
> documentation mailing list
> [hidden email]
> https://lists.openmoko.org/mailman/listinfo/documentation
>
I think Brenda is still a little active in the wiki as user Coolcat.
She always updates the sidebar when there are new community updates.
However it might in fact be better to have a sysop who is more
involved in the project.

_______________________________________________
documentation mailing list
[hidden email]
https://lists.openmoko.org/mailman/listinfo/documentation
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: organizing manuals on the wiki

Patryk Benderz
In reply to this post by Marko Knöbl-2
> >>> What do you think? Is this a good idea?
Very good idea, if you don't mind i will put info about your effort for
next Community update...

--
Kind Regards

Patryk Benderz
IT Specialist
Linux Registered User #377521
+48 22 538 6292

ERSTE Securities Polska S.A.
ul. Królewska 16
Warszawa 00-103
KRS 0000065121
NIP 526-10-27-638
REGON 011136053
Kapitał akcyjny: 15.500.000 złotych (w pełni opłacony)

This message and any attached files are confidential and intended solely
for the addressee(s). Any publication, transmission or other use of the
information by a person or entity other than the intended addressee is
prohibited. If you receive this in error please contact the sender and
delete the material. The sender does not accept liability for any errors
or omissions as a result of the transmission.


Email secured by Check Point

_______________________________________________
documentation mailing list
[hidden email]
https://lists.openmoko.org/mailman/listinfo/documentation
roh
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: organizing manuals on the wiki

roh
Administrator
In reply to this post by Marko Knöbl-2
Marko Knöbl wrote:
> 2009/8/8, Petr Vanek <[hidden email]>:

>>> No replies again ... It's getting a little boring on this list! :-)
>>> As nobody is opposing I think this can be changed as I suggested. Can
>>> one of the sysops (Brenda?) change this? (Replacing "Getting Started"
>>> link on the left with a link to "Manuals"?)
>> afaik very few people has stayed onboard of openmoko, there should be
>> list of people who still do have access to change things if needed.
>> Brenda is gone and i don't see a difference of her having the access or
>> Marko having it... what can we do to change this? get a list of people
>> and extend it somehow?
>>
>> Petr
>>

> I think Brenda is still a little active in the wiki as user Coolcat.
> She always updates the sidebar when there are new community updates.
> However it might in fact be better to have a sysop who is more
> involved in the project.

in case you want to change anything and need more permissions, just holler.

--

Joachim Steiger
ex Openmoko Central Services

_______________________________________________
documentation mailing list
[hidden email]
https://lists.openmoko.org/mailman/listinfo/documentation
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: organizing manuals on the wiki

Marko Knöbl-2
2009/8/11, Joachim Steiger <[hidden email]>:

> Marko Knöbl wrote:
>> 2009/8/8, Petr Vanek <[hidden email]>:
>
>>>> No replies again ... It's getting a little boring on this list! :-)
>>>> As nobody is opposing I think this can be changed as I suggested. Can
>>>> one of the sysops (Brenda?) change this? (Replacing "Getting Started"
>>>> link on the left with a link to "Manuals"?)
>>> afaik very few people has stayed onboard of openmoko, there should be
>>> list of people who still do have access to change things if needed.
>>> Brenda is gone and i don't see a difference of her having the access or
>>> Marko having it... what can we do to change this? get a list of people
>>> and extend it somehow?
>>>
>>> Petr
>>>
>
>> I think Brenda is still a little active in the wiki as user Coolcat.
>> She always updates the sidebar when there are new community updates.
>> However it might in fact be better to have a sysop who is more
>> involved in the project.
>
> in case you want to change anything and need more permissions, just holler.
>
> --
>
> Joachim Steiger
> ex Openmoko Central Services
>

Yes, that would be great!
Could I get permissions to edit the sidebar and delete pages?

marko

_______________________________________________
documentation mailing list
[hidden email]
https://lists.openmoko.org/mailman/listinfo/documentation
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: organizing manuals on the wiki

Marko Knöbl-2
2009/8/11, Marko Knöbl <[hidden email]>:

> 2009/8/11, Joachim Steiger <[hidden email]>:
>> Marko Knöbl wrote:
>>> 2009/8/8, Petr Vanek <[hidden email]>:
>>
>>>>> No replies again ... It's getting a little boring on this list! :-)
>>>>> As nobody is opposing I think this can be changed as I suggested. Can
>>>>> one of the sysops (Brenda?) change this? (Replacing "Getting Started"
>>>>> link on the left with a link to "Manuals"?)
>>>> afaik very few people has stayed onboard of openmoko, there should be
>>>> list of people who still do have access to change things if needed.
>>>> Brenda is gone and i don't see a difference of her having the access or
>>>> Marko having it... what can we do to change this? get a list of people
>>>> and extend it somehow?
>>>>
>>>> Petr
>>>>
>>
>>> I think Brenda is still a little active in the wiki as user Coolcat.
>>> She always updates the sidebar when there are new community updates.
>>> However it might in fact be better to have a sysop who is more
>>> involved in the project.
>>
>> in case you want to change anything and need more permissions, just
>> holler.
>>
>> --
>>
>> Joachim Steiger
>> ex Openmoko Central Services
>>
>
> Yes, that would be great!
> Could I get permissions to edit the sidebar and delete pages?
>
> marko
>
Hi! Is there anything new on this topic? We really need an active
editor who has got more permissions! I don't care if it's me or
somebody else, but there should be someone who can do tasks like
editing the sidebar or deleting pages.

_______________________________________________
documentation mailing list
[hidden email]
https://lists.openmoko.org/mailman/listinfo/documentation
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: organizing manuals on the wiki

Marko Knöbl-2
In reply to this post by Marko Knöbl-2
2009/8/8, Marko Knöbl <[hidden email]>:

> 2009/8/4, Marko Knöbl <[hidden email]>:
>> I finished the first phase of restructuring for the manuals on Neo
>> 1973, Neo FreeRunner, Om 2007.2 and Om 2008. The new manuals are
>> available at
>> http://wiki.openmoko.org/wiki/Manuals
>> The next question is: how do we link to these manuals? I'd propose to
>> replace the "Getting Started" link in the navigation box which is
>> linking to the obsolete page "Getting started with your Neo
>> FreeRunner" - I think we should replace that link with a link to
>> "Manuals" - Is that okay?
>>
> No replies again ... It's getting a little boring on this list! :-)
> As nobody is opposing I think this can be changed as I suggested. Can
> one of the sysops (Brenda?) change this? (Replacing "Getting Started"
> link on the left with a link to "Manuals"?)
>
As I just got the necessary permissions today I just changed this now.
I hope that's okay.

_______________________________________________
documentation mailing list
[hidden email]
https://lists.openmoko.org/mailman/listinfo/documentation
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: organizing manuals on the wiki

Patryk Benderz
[cut]
> As I just got the necessary permissions today I just changed this now.
> I hope that's okay.
Great news! Do you also have perms to delete Candidates for speedy
deletion? This part of wiki  needs some attention too.

P.S. Who exactly gave you permission? I need to speak to her/him
regarding another issue.

--
Kind Regards,       Patryk "LeadMan" Benderz
                    Linux Registered User #377521
()  ascii ribbon campaign - against html e-mail
/\  www.asciiribbon.org   - against proprietary attachments


Email secured by Check Point

_______________________________________________
documentation mailing list
[hidden email]
https://lists.openmoko.org/mailman/listinfo/documentation
Loading...