Add "Improve this page" button to let users easily make quick changes. #98
Conversation
Also change the verbiage of the "Comment on this page" link to the wiki and make it use the same new style of button as the "Improve this page" link.
|
@WalterBright Andrei asked me to prod you both here and on the newsgroup about getting your thoughts on this. |
|
OK, Walter and I would be glad to try this. One thing though - could you please make the buttons smaller? If they're like in the screenshot you sent, they're too big. Thanks! |
|
How's that? See what it looks like on an actual page here: http://gnuk.net/d/index.html |
|
Still a bit too prominent (margins too wide, buttons too large. But I'll approve as is and will mess with it later. |
Add "Improve this page" button to let users easily make quick changes.
|
@andralex Regarding the changes you just made (I can't leave GitHub comment on the commits for whatever reason), I had added a tooltip to the wiki button as you have done but took it out because it goes offscreen on every page but the front page (it doesn't on the front page due to the twitter sidebar). My CSS knowledge is a bit too weak to know how to fix that problem offhand so I just left it out. |
|
@andralex Oh, and I forgot to mention you'll want to mirror your change to std.ddoc too. |
|
@andralex Just created pull request 104 fixes these two issues. |
The goal of this change is to lower the barrier of entry for users to contribute to D's documentation. It essentially turns the website into a moderated wiki. How it works is for each page it links to a special URL on GitHub that will offer to fork the repository, open an online text editor, and create a pull request in one easy process. I've used this method successfully several times to make changes to phobo's documentation and website documentation.
While adding it to the Phobos std.ddoc I also added the Page wiki link.
Find some text you'd like to change and try it out. You can also try it out without actually submitting the pull request if you can't find anything to tweak.
This relies on the now-merged dmd pull request 787 which added a necessary macro to Ddoc. Whoever generates the docs (Andrei?) will need to use a version of dmd that contains that change in order to use this pull request.