On Wed, 19 Dec 2012 11:35:59 +0100
Andreas Jaeger
On Tuesday, December 18, 2012 19:39:58 Rajko wrote:
On Tue, 4 Dec 2012 11:05:24 +0100 ... But we could change that, couldn't we?
Yes, if there is volunteer to visit all pages, so that navigation is still in tact.
... Guidelines are subset of documentation and that is subset of packaging.
I don't see the difference than between Packaging and Packaging_documentation.
I would categorize guidelines and documentation as follows: Guidelines is the law - you shall do it this way documentation is the interpretation: Tips, tricks, howtos
Guidelines are bylaws; in essence mandatory instructions how to do something. Tips, tricks, howtos, are not mandatory, but with guidelines they make documentation, in this case for packaging. Scripts are gray zone, while they can be included in any other form of documents, it would be nice to have them tagged with another category, have them on separate pages (protection and revision history), and when practical transcluded into other articles. We don't use this very much, but rather put scripts in a version control, or keep at home computer, far from users that should be aware of them.
As of right now difference is small, as Guidelines are major portion of documentation, and as we have no habit to publish example scripts in the wiki, there is almost nothing else that will go in packaging category except Portal:Packaging.
Yes, we should define what exactly should be used,
* Packaging - as common category and catch it all for cases where author doesn't know where to put a new article. ** Packaging_documentation for all documents sans scripts, images, lists images. ** Packaging_guidelines - for mandatory part. ** Packaging_howtos - for non-mandatory howtos, tips, tricks ** Packaging_scripts - for scripts that one can copy and paste ** Packaging_images - for article decoration, logos and flow diagrams ** Packaging_lists - for package lists as in packages to drop, to include, for sale, maintainers, minimum maintenance, need an expert, etc. Example of list is what Christian Morales Vega is publishing on mail list as a Factory Status, and it could be published semi automaticly in the wiki, and with some imagination it can be made easy to make it click to mail, click to add name, click to jump to OBS and so on. In other words with little effort we can make wiki central hub for part of textual and visual information that doesn't fit other venues, or that is too far from contributor's attention when elsewhere.
Andreas
-- Regards, Rajko. -- To unsubscribe, e-mail: opensuse-packaging+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse-packaging+owner@opensuse.org