User:Lectrician1/Proposal process
- For lists of proposed features by status, see Category:Proposals by status.
- For proposed icons for existing features, see Proposed Icons.
This page describes the proposal process, which is one of multiple ways to introduce and discuss new tags for features and properties. The other ways are often undocumented.
The proposal process was designed to let the OSM community discuss and vote on a standard way to tag map features. OpenStreetMap does not have any content restrictions on tags that can be assigned to Nodes, Ways or Areas. You can use any tags you like. However, there is benefit in agreeing on a recommended set of features and corresponding tags in order to create, interpret and display a common base map. It is also common to discover various issues during discussion - there may already be a way to map a given feature or it may be desirable to format the proposed tag differently to make it more clear.
Please note: The outcome of a proposal voting (including approval or deprecation of tags) does not have any implications for those tools which use and generate OSM data, such as the standard tile layer renderings or editor presets. Do not expect an approved proposal to be automatically rendered or added to presets; this is at the discretion of the stylesheet maintainers and code authors. Also, never use a vote result as a permission for large-scale re-tagging of existing objects. See automated Edits code of conduct for more about this topic.
This page is designed to assist anyone considering putting forward a tag proposal, with the aim of speeding the tag proposing process. It is not meant as a set of absolute rules, but as a guide.
Proposal list
All proposals are categorised by the status set in its Proposal Page template:
- Full list of proposals including status, date, name and authors - and https://weeklyosm.eu/ mentions proposal voted on, approved, rejected and entering RFC during given week
- Proposed features
- by stage
- Proposals under way – includes proposals with status "In use", "Draft", "Proposed" and "Voting"
- Active proposals – includes proposals with status "Approved"
- by status
- by stage
- Inactive proposals
- All proposals regardless of status
Before creating a proposal
Existing tags/proposals
- Does your proposed tag already exist? Check the Map features page and search Taginfo.
- Is it already a proposal in progress? Check the Proposed features page and the Abandoned feature list.
- Has it been proposed before and rejected? Check the Rejected features page.
- Being a rejected feature does not necessarily mean it should not be proposed again: some proposals fail due to a poor definition, being ambiguous or lacking information to justify their significance, some items become more significant over time and thus more map-worthy.
- Is there any other work not referenced on these pages? Perform a general search on the wiki, including related words.
- When designing new tags, you can consult for example International Orienteering Federation's mapping specifications with their standard categories, IDs and descriptions, that might be of use; how are some users classifying their interests.
For example:
- You want a tag for a racecourse; consider searching for "racing", "horse", etc.
- You want a tag for a peninsula; consider searching for "headland", "point", etc.
- You want a tag for a brewery; consider searching for "beer", "manufacturing", "alcohol", "industrial", "plant", "works", etc.
It might also be a good idea to send an email to the tagging mailing list, describe the feature you want to tag and see if there are tags in use but hard to find or not yet documented.
Significance
Is the tag you are considering for proposal, worthy of a new tag? Consider possible uses for the map, and specifically the data you want to add.
This is a difficult judgement to make: if you want to tag it, then that is generally reason enough to create a tag.
- Is it a destination in itself?
- People may search for some locations, for example: a national park, a bus station, a street address or a rubbish dump, because they want to visit that location.
- How many of the item do you think there will be in the world?
- For instance, you want to map an aero-engine factory - there are very few aero-engine factories in the world, so rather than creating a specific tag, this may be better served by using an existing man_made tag and specifying product=aero_engines.
- How large is the item?
- Large items can assist with navigation.
- Is it useful for research/study?
- A geography student may want to determine the total area of national parks in a given region.
- A sociology student may want to map correlation between number/location of Porsche dealerships and houses greater than 600 m2 in area.
- A history student may want to show the locations of all battles in a given war.
- Does it assist in route-planning?
- It is useful to know which junctions are traffic lights and which are roundabouts as this can affect journey times.
- Truck drivers need to know the maximum height allowed under bridges, or the maximum weight allowed through population centres.
- Traffic calming structures can affect journey times, routing software will generally not use roads with these on.
- Walkers would want to know surfaces/conditions of walking tracks.
Compatibility with established practices
OpenStreetMap has some established good practices. Your proposal should follow those or at least explain why it does not do it. Please have a look at them.
Specifically relevant for proposals might be
- Verifiability
- Tags that are approved are usually features or properties that an individual mapper can confirm to be correct or false. A tag is verifiable if independent users would make the same observation.
- This means that statistical properties (like peak vehicles per hour on a road) and subjective content (reviews, rankings) are not included in OpenStreetMap. Temporary, historic or speculative future developments are also excluded.
- One feature, one OSM element
- A single real world object should be represented with one element only.
- Syntactic conventions for new tags
- There are some conventions about naming keys and values. Following them will help mappers to estimate the meaning of your tags without reading the documentation. Using a semicolon should be considered especially carefully.
Skimming though Editing Standards and Conventions might be helpful as well. Please also consider the On the Ground Principle (about current versus old data), fixme=* (for estimations), and names (names versus descriptions, avoiding abbreviations) if any of them might conflict with your ideas.
Creating a proposal page
Create
You can easily create a pre-formatted proposal here.
Create the page and immediately save to convert the substituted values to text.
Then add detail parameters to the Proposal Page template at the top of the page and fill in the headings according to the instructions below.
Page details
In general: be verbose. The more information you can include, the better. Photos, descriptions, situations, examples. Anything to create a well-defined image in people's mind.
More specifically: this list is a starting point for items you may want to consider putting in your proposal:
- Proposal
- A short description of what you want to map, including links to relevant material with photos if possible. This section should clearly state what new tags will be added, and what tags will be deprecated (if any). Consider using a table if your proposal involves multiple tags.
- Rationale
- Why the tag is needed, considering significance and potential uses of the data.
- Examples
- Names, locations, rough idea of numbers (e.g., one on every street corner, several in each suburb in Germany, half a dozen in each South American country).
- Tagging
- The category the tag falls under (man_made, waterway, tourism, etc,), with a justification of why other similar categories are not suitable (for instance, there may be too many to map individually - such as residential properties in which case a landuse tag would be of more use if they are grouped closely enough?).
- The name of the tag itself - keep it as short as possible (15 characters is generally as long as they get), whilst still being logical, descriptive enough to need little explanation and not overlapping with another tag in a different category. British English terms are preferred.
- Other significant tags to describe specific instances of the item (e.g., author for a work of art, contents for a pipeline, etc.).
- Generic tags that are re-used extensively (e.g., name, operator, access, etc.).
- Applies to
- Nodes, ways or areas; when considering nodes vs areas: generally, if an item is smaller than 5 m by 5 m, it would not be mapped as an area, but as a node.
- Rendering
- Not a part of the proposals process as such, but hints for the renderer maintainer will help them out. maybe a description of an icon (refer Map Icons), or an example mock-up. Usually may be safely omitted from proposal.
- Features/Pages affected
- What keys/tags and Wiki pages might this proposal affect if approved?
- External Discussions
- Please link here to discussions about the proposal on external sites (mailing lists, forum, ...).
- Comments
- There must be a time set aside for other people to comment on the proposal, do not go straight to a vote. The wiki talk page is used for comments, it is linked from the proposal page for those unfamiliar with wikis.
Optionally let people know of your new proposal by subscribing to tagging mailing list and sending a mail.
Proposed
- Once the feature is fully described on its page, move on to
Proposed
Status. - You must subscribe the Tagging mailing list for the next steps. Do this before you write any email to this list.
- Send out an RFC (Request For Comments) to the Tagging mailing list (taggingopenstreetmap.org).
- Subject: "Feature Proposal - RFC - (Feature Name)"
- In the body: include a link to the proposal page on the wiki. Also copy the "definition" from that page and paste it in the mail.
- Set the status to
Proposed
and set therfcStartDate=2024-12-25
value. (YYYY-MM-DD) - Spend time with others discussing and modifying the proposal.
- Please discuss each proposed feature on its own discussion page.
Voting
- You still have to be subscribed to the Tagging mailing list for these steps.
- At least two weeks after the RFC, and once problems brought up in discussion have been resolved by modifying the proposal, send out a Request for Voting to the tagging mailing list:
- <Subject:> "Feature Proposal - Voting - (Feature Name)"
- Set the status to
status=Voting
at the top of the page - Set the voting start date: like
voteStartDate=2024-12-25
. - Set the projected end date
voteEndDate=2025-01-08
(usually 14 days after the start). - Add this to the bottom of the page:
== Voting == {{Proposed feature voting}} <!-- Cheat sheet: {{vote|yes}} OPTIONAL MESSAGE HERE --~~~~ {{vote|no}} YOUR REASONS HERE --~~~~ {{vote|abstain}} YOUR COMMENTS HERE --~~~~ Place your vote below, at the end of the list. -->
- At this point there must be only one proposal on the page, which should not be changed anymore, so it's clear what is being voted on.
- If you don't get enough votes/feedback after two weeks, the voting-period should be extended and you should send out a second mail to the list.
- People should not just vote "oppose", they should give a reason for their proposal, and/or (preferably) suggestions.
- If it becomes apparent during the voting period that the proposal is unlikely to be approved, it is acceptable to suspend the vote early so that the proposal can be re-worked.
- A list of active votes can be found at Category:Proposals with "Voting" status.
Post-vote
- If you have no time to do the cleanup after the voting has ended:
- Mark the proposal status as
status=Post-Vote
.
- (See Category:Proposals without post-vote cleanup for features needing clean-up. If you have a minute, pick up a broom and clean up!)
- After the voting period, make a summary of the voting by filling out the parameters of the {{Proposed feature voting}} template:
{{Proposed feature voting | closed = yes | yes = | no = | abstain = | result = approved/rejected | comment = }}
Approved
If the proposal has found enough support, the status can be set to Approved
.
- A rule of thumb for "enough support" is 8 unanimous approval votes or at least 10 votes with more than 74 % approval, (a simple way of counting is that a minimum of 3 yes votes for every no vote is certainly sufficient[1]), but other factors may also be considered (such as whether a feature is already in use).
- The explicit abstentions do not count as a vote (e.g. 10 vote "yes", 1 vote "no", 10 "abstain but have comments" would be approved), but all suggestions should be taken into account before a proposal is approved or rejected in order to resolve any deficiencies in the original proposal (if they exist).
- Before you decide to reject a proposal because of lack of support, it may be worthwhile to send out a new vote request to the mailing list.
- (Historic note: prior to March 2015, the standard for approval was 8 unanimous votes or a 50% majority if there were more than 15 votes. Older proposals are still considered "approved" if they met the standard in place at the time.)
Clean up the proposal:
- Do not move the proposal page!
- Create the permanent feature description page:
- A new page for the feature should be created and the relevant map features template (depending on whether it is a key, a value, or a relation) should be applied. Follow the standard set by the Key:highway key and its values.
- Add a link back to the proposal by using the statuslink parameter of the feature template.
- Add a link to the permanent feature page in the proposal page using Template:Approved feature link.
- Archive the proposal using Template:Archived proposal.
- Add the completed feature to the map feature page:
- Add entry to Map Features page.
- Do not remove entries from Map Features even if your new feature that has been voted on is intended to replace them. It is not considered good style to remove things from Map Features while they are still in use. You can remove things from Map Features if they are not in use. See also Deprecated features.
Rejected
If the vote fails, the status can be set to Rejected
.
- Note any reasons why rejected on the feature proposal page.
- Rejected features may be resubmitted, modified, and moved back to the RFC process.
Abandoned, Canceled, Obsoleted, Undefined
- Proposals should be set to
Abandoned
if they have a long time of inactivity (at least 3 months) on the wiki pages (including all languages and discussion pages) and are also not added to the OSM database. A proposal that's unchanged in the wiki for a while might just be tested in daily mapping practice and thus may be very alive. - The person proposing a feature can cancel it by setting the status to
Canceled
. - For proposals that have been obsoleted by another proposal, set the status to
Obsoleted
. - For proposals with unknown status, set the status to
Undefined
.
Non proposed features
Non-proposed features are mapping features which did not undergo the proposal process.
Even if OSM has a completely free data model (that is, you don't need anyone's permission), we try to moderate the Map features list for several reasons:
- landing page for newbies: so it has to be clear and self-explanatory in every language
- avoid feature conflicts: during a vote all eyes can keep duplicates away
- keep list/categories short: even a design decision, we want to avoid an uncontrolled explosion of features and keys
Generally, new keys should always be discussed before being added to Map features. To increase participation in discussion, especially for new values of major keys like highway=* it is a good idea to formally propose them. Any new tag which replaces an existing tag requires also a proper discussion.
Reviving old proposals
There are many old proposals that never reached vote stage and where the original authors have abandoned them. What can be done by a new unrelated person interested in making identical or a similar proposal?
- restart the old proposal - it is a good idea if you completely agree with it. Consider contacting the original author whenever it is OK for you to resurrect it - and wait some time for reply. Send it again to request for comment (RFC) stage and continue to proceed like with any other proposal.
- make a new proposal reusing content from the old one. Simply create a new page, feel free to copy existing content (you are allowed to do this, just mention source of text in the changeset comment). Mention inspiration/source of the proposal, but feel free to make any changes to it that you want. And proceed like with any new proposal. You can also do this with your own proposals.
Examples
- Proposed features/man made=bridge is case of a simple reviving - person who started vote fully agreed with the original author, proposal was not modified
- Proposed features/scuba diving2 was based on a previously proposed but not finalised Proposed_features/scuba_diving, proposals were made by different people
- healthcare=blood_donation proposal was based on the earlier proposal made by the same person that was rejected
Proposal process wiki history
You can find the history for this page there (as usual).
Notes
- ↑ For example 26 yes votes and 9 no votes is 74.3% of support that is sufficient. "3 yes for 1 no" means that proposal achieved 75% support, while 74% is sufficient