ubuntu-manual team mailing list archive

[Benjamin Humphrey <humphreybc@xxxxxxxxx>]

Hey Martin,

Yeah I agree, the branch is a bit crazy. We are going to move all the
website stuff over to a new project soon. The screenshots folder is used to
import the screenshots back into LaTeX as far as I know.

The other things that we're not using can be deleted from the branch and
stored locally on someones computer as a backup, but we'll get to doing all
this after Lucid when the pressure is off and we don't run the risk of
killing translations by playing with the branch.

Cheers

2010/4/11 Martin Lukeš <martin.meridius@xxxxxxxxx>

> Call me psycho but I like when everything has its own place.
> I went through our main branch and put together folders and their actual
> meaning. And here is a result:
>
> Chapters in manual and their folders:
> Cover                          frontmatter
> Copyright                      frontmatter
> 0 Prologue                     prologue
> 1 Installation                 installation
> 2 The Ubuntu desktop           around-desktop
> 3 Working with Ubuntu          default-apps
> 4 Hardware                     prefs-hardware
> 5 Software Management          software-packaging
> 6 The Command Line             command-line
> 7 Security                     security
> 8 Troubleshooting              troubleshooting
> 9 Learning more                learning-more
> A License                      backmatter
> Glossary                       frontmatter
> Credits                        credits
> Index                          backmatter
>
> The rest of the folders and their actual meaning:
> graphics            <icons used in manual>
> Help                <"How to..." slides for authors, editors, translators,
> ...>
> lucid-screens       <are we using this? - screenshots have its own
> branch/project>
> maintenance         <chapter removed>
> pkgs                <stuff for compiling manual>
> Planet Stuff        <stuff for our Planet>
> po                  <.po files for all languages>
> screenshots         <are we using this? - screenshots have its own
> branch/project>
> team-images         <images for our web>
> titlepage           <old Wolter's Lynx>
> website             <stuff for our website>
>
>
> Don't get me wrong but I thing this is a mess.
> Since we have our web and planet and their stuff together with stuff for
> manual. Plus a few folders no longer used. We hardly know where to find
> what.
> Now you may say WE do find all we need. But think for the future. Not that
> I wish it, but what if (for example) couple of editors leave, new one comes
> and instead of immediately start writing, they will have to go through all
> this mess and find what folder contains what. This will consume their
> valuable time.
>
>
> What I suggest is simple: Make an order.
> Instead of having countless folders in root, move them to a few appropriate
> folders.
> For example:
> manual-chapters/
>     all manual chapters
> website/
>     stuff for our website
>     team-images/
> planet/
>     stuff for our Planet
> Help/
>     "How to..." slides for authors, editors, translators, ...
> graphics/
>     icons and other graphics used in manual
> pkgs/
>     stuff for compiling manual
> po/
>     .po files for all languages
>
> Or split them into multiple branches if it will be more convenient.
>
>
> And since we have separate project for screenshots I guess we no longer
> need an images/ subfolder in each chapter folder.
>
>
> I don't mention files in root since I don't know what most of they are for.
> ;) Nevertheless they could be in appropriate folder(s) too.
>
>
> Thoughts?
>
> ---
> Regards
> Martin Lukeš
> P.S.: Please keep the communication history
>
> _______________________________________________
> Mailing list: https://launchpad.net/~ubuntu-manual
> Post to     : ubuntu-manual@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~ubuntu-manual
> More help   : https://help.launchpad.net/ListHelp
>
>


-- 
Benjamin Humphrey

Ubuntu Manual Team Lead
Dunedin, New Zealand

http://www.ubuntu-manual.org
www.interesting.co.nz