Getting started documentation is not very searchable

Bug #649764 reported by zpletan
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
Launchpad itself
Triaged
Low
Unassigned

Bug Description

Launchpad r11641
The documentation, both on the +new-recipe page and on https://help.launchpad.net/Packaging/SourceBuilds/Recipes, does not give a wanna-be packager (such as myself) enough information to get started. Coming at this from the perspective of a total noob, I don't know:
a) What /exactly/ does build daily do? Does it build it daily, period? Does it check every day for new revisions and if it finds them, builds it? What if I don't check it? Will it only build on new revisions if I don't check the box, or does not checking the box mean I need to run the recipe manually?
b) What is a daily build archive and why can't I write a recipe without one?
c) What is a default distribution series and why can't I write a recipe without one?

The actual recipe text format is very well documented, but the recipe process is not so well explained.

Tags: lp-code
Revision history for this message
zpletan (zpletan) wrote :

OK - I found some great documentation via Google @ https://help.launchpad.net/Packaging/SourceBuilds/GettingStarted . The problem is that if one goes to help.launchpad.net and searches for recipe, one gets the SourceBuilds/Recipes page.

Revision history for this message
Aaron Bentley (abentley) wrote :

The Getting Started documentation is linked at the top of https://help.launchpad.net/Packaging/SourceBuilds/Recipes but perhaps we should put "recipe" in the title so that a title search of "recipe" will find it.

summary: - recipes documentation not helpful enough
+ Getting started documentation is not very searchable
Changed in launchpad-code:
status: New → Triaged
importance: Undecided → Low
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.