[irods/irods#8605] Document Consortium's stance on API and ABI stability (main)#388
[irods/irods#8605] Document Consortium's stance on API and ABI stability (main)#388korydraughn wants to merge 1 commit intoirods:mainfrom
Conversation
alanking
left a comment
There was a problem hiding this comment.
Looks good to me.
My only hesitation is whether this needs its own dedicated page. I'm wondering whether there's a more general space we can use or create. Maybe a slightly more general "Version Compatibility" page or something like that? It feels like it's very limited in its scope for what could go in here in the future. All that being said, I'm fine with things as they are as well.
|
That crossed my mind as well. If you see an alternative place to put it, let me know. Given your recent issue about |
|
agreed - let's hold on this for a little bit and think through what we DO want to say... as well as whether there is a more general place for it than its own page. |
|
This PR needs to cover irods/irods#8310. Moving forward, we need to limit changes to packing instructions to major releases. That helps in maintaining API stability. |
Here's a screenshot of the rendered documentation.
And here's what the navigation menu looks like. Tried to remove the button to the left of the section title, but failed. Also didn't spend a lot of time on that part.