<p></p>
<blockquote>
<p>moving the API documentation from the wiki to the rails port would put the onus on the current maintainers (but see above)</p>
</blockquote>
<p>Valid point, I also thought about it and came to the following conclusion: OSMF board again has <a href="https://wiki.osmfoundation.org/wiki/Board/Minutes/2021-02-S2S/Discuss_institutionalising_budgeting_and_fund-raising_processes" rel="nofollow">expressed</a> their willingness to fund topics like "<em>Andy Allan's "room by room" renovation - API overhauling</em>" by having a "part-time maintainer to assist Andy Allan.". While people in this repo may find it difficult to exactly grasp what they mean by API renovation, we should definitively leverage the momentum on the API topic.</p>
<p>I believe getting a new paid resource up to speed by improving documentation has a number of benefits:</p>
<ul>
<li>Good way to get familiar with the existing Rails code base</li>
<li>Clear task with no impact on existing code base (-> less effort for maintainers to review potentially breaking pull requests)</li>
<li>Better documentation would improve overall developer experience</li>
</ul>
<p>I think <a class="user-mention" data-hovercard-type="user" data-hovercard-url="/users/gravitystorm/hovercard" data-octo-click="hovercard-link-click" data-octo-dimensions="link_type:self" href="https://github.com/gravitystorm">@gravitystorm</a> would agree that Rails port will continue to be the center of gravity for functional requirements, database table definitions and a reference implementation, regardless of what we're doing in production.</p>

<p style="font-size:small;-webkit-text-size-adjust:none;color:#666;">—<br />You are receiving this because you are subscribed to this thread.<br />Reply to this email directly, <a href="https://github.com/openstreetmap/openstreetmap-website/issues/3107#issuecomment-781897861">view it on GitHub</a>, or <a href="https://github.com/notifications/unsubscribe-auth/AAK2OLO3MJOMUYO3SUBOD73S7YJLHANCNFSM4X3EHRGA">unsubscribe</a>.<img src="https://github.com/notifications/beacon/AAK2OLK7QJSEZTMRFFNW3L3S7YJLHA5CNFSM4X3EHRGKYY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOF2NNBBI.gif" height="1" width="1" alt="" /></p>
<script type="application/ld+json">[
{
"@context": "http://schema.org",
"@type": "EmailMessage",
"potentialAction": {
"@type": "ViewAction",
"target": "https://github.com/openstreetmap/openstreetmap-website/issues/3107#issuecomment-781897861",
"url": "https://github.com/openstreetmap/openstreetmap-website/issues/3107#issuecomment-781897861",
"name": "View Issue"
},
"description": "View this Issue on GitHub",
"publisher": {
"@type": "Organization",
"name": "GitHub",
"url": "https://github.com"
}
}
]</script>