Skip to end of metadata
Go to start of metadata

<h1>Authoring a proposal</h1>

<ac:macro ac:name="toc"><ac:parameter ac:name="type">list</ac:parameter><ac:parameter ac:name="indent">20px</ac:parameter><ac:parameter ac:name="minLevel">3</ac:parameter><ac:parameter ac:name="printable">true</ac:parameter></ac:macro>

<p><br class="atl-forced-newline" /></p>
<h3>How do I create my proposal?</h3>

<p>From the <ac:link><ri:page ri:content-title="Home" /><ac:link-body>proposal homepage</ac:link-body></ac:link> you will find a link to create a new proposal under the section "Submitting a New Proposal". This will ask you for the name of the proposal. Enter its name followed by your own—for example, "Zend_Magic - Harry Houdini". A proposal template will be generated, and your proposal will now be ready for editing. Instructions for the basic steps that need to be performed will be at the top of the page.</p>

<ac:macro ac:name="note"><ac:parameter ac:name="title">Ignore preview pane errors!</ac:parameter><ac:rich-text-body>
<p>When creating a new proposal and editing the wiki markup for it, you will likely click on the preview pane at some point. Currently, the preview pane for this plugin generates several errors. Do not be alarmed by them; your page should save correctly provided that the wiki markup is valid. In any case, you can always edit the page again after saving, so please do not postpone saving your new proposal because of errors on the preview pane. We will correct this issue as soon as we can. Thanks!</p></ac:rich-text-body></ac:macro>

<h3>The page created for my proposal contains all of these special zone-data tags. What's that about?</h3>

<p>These tags wrap the content for your proposal, and allow us to apply a template in real time so that we can change the formatting, add new fields, and keep uniformity between the proposals. By looking at the sample data and by looking at the page in view mode, you can infer the meaning of each. When you enter edit mode, just replace the sample content with your own.</p>

<p>If you make a mistake, or accidentally remove any tags, just look at the source of another proposal to find what you are looking for.</p>

<h3>Why does my new proposal say "Zend_Magic Proposal"?</h3>

<p>The default page created for you contains sample content that you should change. Otherwise you may be forced to write the Zend_Magic component, which is one of the tougher ones to do.</p>

<h3>How do I do this wiki formatting thing?</h3>

<p>First, you can use the WYSIWYG editor, although for proposals it is better to modify wiki markup by hand. The WYSIWYG editor is never as good as hand-markup if you are a heavy user of macros, or cool things like templates. Thankfully, on the right-hand side of the editor is a quick help guide that is visible at all times. You can click that link for the full guide (at the top of the Help Tips) to see all markup options. It's based on Textile and pretty easy to learn, and generally good to know when working on the wiki.</p>

<h3>When I put PHP code in my page, why do I get errors?</h3>

<p>You need to wrap the code with

Unknown macro: {<code>code</code>}

tags before and after the code sample. Otherwise, the open and close curly braces will appear to be wiki tags.</p>

<h3>What should I concentrate on for my proposal?</h3>

<p>In the early stages, concentrate on use cases, goals, and the purpose of the proposal so that the design can be measured against these requirements. Later, flesh out the API and class relationships, along with the theory of operation (how you perceive it will work). Once those elements are fairly stable, start to concentrate on the code.</p>

<h3>When will my proposal move to the Laboratory?</h3>

<p>If your proposal shows promise but doesn't directly contribute to the current roadmap, it may be accepted into the Laboratory for continued development as a component. In this case, your project will receive space in the Subversion repository and an issue tracker assigned to it. Successful Laboratory projects are candidates for future inclusion within the framework core. </p>

<h3>When will my proposal move to the Incubator?</h3>

<p>Accepted core proposals are moved to the Incubator and become part of the main release track. If your project was previously a part of the Laboratory, its issue tracker and repository will move into the main project at this time. For proposals moving directly into the Incubator, repository space will be created.</p>

<p>Laboratory projects without basic DocBook documentation and unit testing are unlikely to move into the Incubator. Also, please following the <ac:link><ri:page ri:content-title="PHP Coding Standard (draft)" ri:space-key="ZFDEV" /><ac:link-body>Zend Framework coding standards</ac:link-body></ac:link>, as that can also be a blocking point.</p>

<h3>Do I need to include requirements, acceptance criteria, milestones, and so on?</h3>

<p>Yes. Often the details and number needed are quite small, but without knowing the requirements and milestones, how will the community know the status of the component, when it will be "done", and what should be expected when it is?</p>

proposals proposals Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. Oct 27, 2006

    <p>It says this " NOTE: this page is editable by everyone, so if it isn't clear, update it!", but I do not see any Edit link, am I missing something?</p>

  2. Oct 30, 2006

    <p>"From the Zend Framework Proposal Home Page you will find a link to create a new proposal". <br />
    Where's this link???</p>

    1. Dec 21, 2006

      <p>The previous comment is 2 months old and I cannot find any link yet on the 'proposals' page. Do you really want new proposals ? Maybe I missed something but, if it the case, it is REALLY hard to find.</p>

      <p>But will somebody read this post ?...</p>

      1. Dec 21, 2006

        <p>I've edited the section to be more clear. The "Submitting a New Proposal" section is on the right-hand side of the page.</p>

  3. Dec 12, 2009

    <p>I also want to add that in order to edit the newly created proposal page you must click "Page Operations" on the left hand side (which was not expanded by default for me).</p>