Timeline for Allow users to edit the API documentation
Current License: CC BY-SA 3.0
20 events
| when toggle format | what | by | license | comment | |
|---|---|---|---|---|---|
| Jun 4, 2018 at 12:37 | comment | added | Stijn | @JonEricson please don't give users false hope and pretend that these reports will be looked at... | |
| Mar 29, 2018 at 15:49 | comment | added | Sonic the Anonymous Hedgehog | @ShadowWizard As Jon Ericson mentioned earlier, there was a plan to move API docs to Documentation, which would make it editable. | |
| Mar 29, 2018 at 15:44 | comment | added | Jon Ericson StaffMod | @SonicWizard: Probably depends on the typos. If you have a pile of its <=> it's, spelling and grammar changes, maybe put it in a single post so you don't flood meta with trivia. If it's a more nuanced and individual problem, like a mismatch between the documentation and the way the API behaves, that might work better in a separate question. | |
| Mar 29, 2018 at 6:59 | history | edited | Shadow Wizard |
edited tags
|
|
| Mar 29, 2018 at 6:58 | comment | added | Shadow Wizard | @Jon can you please explain the decline in an answer? Comments are temporary and can vanish without notice. Also, how is Documentation relevant? Maybe you misunderstand the request here? It's about the API used by programmers, not about the dead Documentation project. (I removed the misleading tag.) | |
| Mar 29, 2018 at 5:44 | comment | added | Sonic the Anonymous Hedgehog | @JonEricson So what's the preferred way to have typos fixed in the API documentation? Report a bug on Meta for each? | |
| Mar 29, 2018 at 5:29 | comment | added | Jon Ericson StaffMod | One more hopeful item to relay is that Enterprise and Teams are gearing up to offer the API to customers. As much as possible we are working to keep the code and documentation synced across all three products. That means there's some hope API bugs and feature requests will be addressed more quickly than in the past. | |
| Mar 29, 2018 at 5:25 | history | edited | Jon EricsonStaffMod |
edited tags
|
|
| Mar 29, 2018 at 5:24 | comment | added | Jon Ericson StaffMod | @ashleedawg: Unfortunately, we had to shut down Documentation last year. So we don't plan on allowing users to edit the API documentation anymore. However, we do welcome bug reports and feature requests here on Meta Stack Exchange. Use the api tag and we'll get it to the developers. Sorry to disappoint. :-( | |
| Mar 29, 2018 at 2:41 | comment | added | ashleedawg | Hi @JonEricson, just wanted to pass along some frustration felt by myself and a number of other users new to the API, entirely related to obvious errors in the documentation. Beyond the wasted hours & headaches, this could cause "unintentional abuse" of the API by apps planned around faulty information. Do you happen to know a timeline for the changes you mentioned? In the meantime, if you were to ¼ the req'd rep to edit the docs, still only 4 [recently active] users would have the privilege but would make a big difference. | |
| Apr 13, 2017 at 12:25 | history | edited | CommunityBot |
replaced http://stackapps.com/ with https://stackapps.com/
|
|
| Mar 20, 2017 at 10:30 | history | edited | CommunityBot |
replaced http://meta.stackexchange.com/ with https://meta.stackexchange.com/
|
|
| Jan 31, 2017 at 11:48 | comment | added | Stijn | @JonEricson That's great, the only thing preventing a move to Documentation currently is the lack of a "Try It" section. I'm working on an API client in my spare time currently, and writing docs in the process. Can I put those docs on Documentation already, or do you prefer waiting until you have more details? | |
| Jan 30, 2017 at 23:23 | comment | added | Jon Ericson StaffMod | @haykam: That's not in the plans at the moment. To keep things simple, we'll probably just copy the existing "Try It" section. (I see there's some potential confusion by my phrasing. That's all I meant by "console".) | |
| Jan 30, 2017 at 23:10 | comment | added | bb216b3acfd8f72cbc8f899d4d6963 | @JonEricson Does this mean a sort of command line interface for testing Node.js or other languages? If so, will they be able to be copied from a code block into the CLI? | |
| Jan 30, 2017 at 21:55 | history | edited | Jon EricsonStaffMod |
edited tags
|
|
| Jan 30, 2017 at 21:55 | comment | added | Jon Ericson StaffMod | We are planning on most of the API documentation to Documentation sometime this spring. We've had several companies express interest in embedding an API console on Docs and the obvious way to build that up is with our own API. For now I'm marking this as planned and more details will follow as we know more. | |
| Jan 24, 2017 at 4:55 | comment | added | Jeffrey Bosboom | Clearly the API documentation should be moved to SO Docs. | |
| Jan 23, 2017 at 19:14 | comment | added | Nathan Tuggy | Hmm, there's not a ton of suggested edit reviewers there either, are there? | |
| Jan 23, 2017 at 18:56 | history | asked | Awesome Poodles | CC BY-SA 3.0 |