+new-recipe needs an introductory sentence plus a link to help

Bug #667274 reported by Matthew Revell
24
This bug affects 3 people
Affects Status Importance Assigned to Milestone
Launchpad itself
Fix Released
High
Tim Penhey

Bug Description

The page on which one creates a new source recipe does not explain what source recipes are nor how to write them.

The recipe text box is pre-populated but its contents are not explained.

We can fix this with an introductory paragraph/sentence under the headline (between the headline and the "this stuff's new, file a bug" box that's there right now) that links to the relevant section of the help wiki.

We should then add a pop-up help link close to the recipe text box. I propose a help pop-up, rather than a link to the help wiki page because I think it will be easier to refer to the help pop-up in the page while writing the recipe.

Related branches

Revision history for this message
Martin Pool (mbp) wrote : Re: [Bug 667274] [NEW] +new-recipe needs an introductory sentence plus a link to help

On 27 October 2010 09:10, Matthew Revell <email address hidden> wrote:
> We should then add a pop-up help link close to the recipe text box. I
> propose a help pop-up, rather than a link to the help wiki page because
> I think it will be easier to refer to the help pop-up in the page while
> writing the recipe.

It's true it does come up in the same window/tab, which is good, but
there are some disadvantages:
- help popups can't be moved to a separate window on the desktop so
you can see them side by side
- as implemented in other apps, it blocks interaction with the dialog
- they don't have a url that can be pasted in irc etc
- it's much harder to change the text and improve it

--
Martin

Tim Penhey (thumper)
Changed in launchpad-code:
status: New → Triaged
importance: Undecided → High
tags: added: recipe
Changed in launchpad-code:
assignee: nobody → Tim Penhey (thumper)
Revision history for this message
Tim Penhey (thumper) wrote :

I've added text to the top of the page, but right now it shows below the warning box saying that recipes are in beta due to the way the main template works. I think this is OK for now as we are aiming to get recipes out of beta ASAP.

Changed in launchpad-code:
status: Triaged → In Progress
Revision history for this message
Launchpad QA Bot (lpqabot) wrote : Bug fixed by a commit
Changed in launchpad-code:
milestone: none → 10.11
tags: added: qa-needstesting
Changed in launchpad-code:
status: In Progress → Fix Committed
Tim Penhey (thumper)
tags: added: qa-ok
removed: qa-needstesting
Revision history for this message
Martin Pool (mbp) wrote : Re: [Bug 667274] Re: +new-recipe needs an introductory sentence plus a link to help

That looks nice.

Changed in launchpad-code:
status: Fix Committed → Fix Released
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Duplicates of this bug

Other bug subscribers

Bug attachments

Remote bug watches

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