Skip to end of metadata
Go to start of metadata
You are viewing an old version of this page. View the current version. Compare with Current  |   View Page History
Ignore Errors on Preview Pane
When creating a new proposal and you are editing the Wiki markup for it, you may click on the Preview pane to see what it looks like before you Save. Currently, the Preview pane for this plugin generates several errors that we are working to correct. Do not be alarmed by the errors; your page should Save correctly provided that the Wiki markup is valid. In any case, you can always edit the page, so please do not postpone saving your new proposal because of errors on the Preview pane, and we will strive to fix the problem as soon as reasonably possible. Thank you for your continued patience!

NOTE: this page is editable by everyone, so if it isn't clear, update it!

Knowing What to Expect When Authoring a Proposal (AKA Proposal FAQ)


How do I submit my proposal?

From the proposal homepage you will find a link to create a new proposal under the section "Submitting a New Proposal". This will ask you for the name, usually something like "Zend_Magic Proposal" and then create a proposal from a template, and fill it with sample data. This page is now saved and ready for editing. Instructions for the basic steps that need performed will be at the top of the page.

The page created for my proposal contains all of these special zone-data tags, what is that about?

These tags wrap the content for your proposal. 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 contents with your own to fill out the proposal. What you are doing is really just setting the value of variables that a template will render against to create your page when viewed.

These tags allow us to apply a template in real time to the proposals so that we can change the formatting, add new fields, and keep uniformity between the proposals.

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.

Why does my new proposal say Zend_Magic Proposal or Zend_Something_Or_Other?

The default page created for you contains sample content, you should now change that to be what you wish it to be. Otherwise you may be forced to write the Zend_Magic component which is one of the tougher ones to do.

How do I do this Wiki formatting thing?

One, 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 the link for the full guide (at the top of the Help Tips) to see all markup options. It is quick to learn, based on Textile, and a good thing to know when working in our wiki a lot.

If I put PHP code into my page, sometimes I get errors!

You need to wrap the code with {code} tags before and after the code sample. Otherwise the open and close curly braces will appear to be wiki tags.

What should I concentrate on for my proposal?

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 in how you perceive it working.

Once you are fairly stable with those elements, then start to worry about code.

When will my proposal get space in the "Laboratory?"

When proposals are moved into "under review" they will have a issue tracker setup for them, as well as possibly a Laboratory SVN project created if coding needs to be done to prove out the proposal.

Proposals that are not accepted into Incubator right off, may want a Laboratory SVN project to support ongoing development so that they can continue to work on the component. The issue tracker will work hand-in hand with that as well.

When will my proposal move to "Incubator?"

Accepted proposals will move to Incubator meaning that they are part of the main release track. Their issue tracker will merge into the main framework project and become a component of that project rather than a stand-alone project. Their SVN repository (if they have one in Laboratory) will move into a subdirectory within the main project.

Projects are unlikely to move to Incubator that do not have basic DocBook documentation and are showing signs of having decent test coverage. Also please following the [Zend Framework coding standards] as that will be a blocking point as well.

Do I need to include requirements, acceptance criteria, and milestones/tasks ?

Yes. Often the details and number needed are quite small, but without knowing the requirements (what exactly should the component do), and milestones, how will the community know the status of the component, when it will be "done", or what to expect when it is "done"?

Labels:
None
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.