digitalmars.D - "Improve this page"
- Brad Anderson (26/26) Mar 15 2012 I have a pending pull request
- James Miller (17/40) Mar 15 2012 ges
- Simon (6/42) Mar 16 2012 I think it looks fine and it's a great idea. At least for those of us
I have a pending pull request <https://github.com/D-Programming-Language/d-programming-language.org/pull/98> which adds an "Improve this page" button to the upper right corner all pages on the website. From the pull request description: "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." It's meant for simple changes (typos, rewording stuff, minor bugs in code examples, etc.). I got the idea after using the GitHub online editor myself to make website and Phobos documentation change pull requests and finding it to be very easy way to contribute. Even people who are unfamiliar with git can use it. Andrei seemed to like it when I showed him but asked me to get Walter and whoever else's opinions on it before he'd be willing to merged it. You can try a live demo here: http://gnuk.net/d/index.html Clicking the button will open the appropriate file in an editor on GitHub. Feel free to click the button to see what the editor is like. Nothing happens until you choose to submit your changes at which point it lets you enter a pull request description, then it finally makes the request. This would probably have been difficult to implement if it weren't for Ddoc so +1 for Ddoc. Regards, Brad Anderson
Mar 15 2012
On 16 March 2012 17:14, Brad Anderson <eco gnuk.net> wrote:I have a pending pull request <https://github.com/D-Programming-Language/d-programming-language.org/pul=l/98>which adds an "Improve this page" button to the upper right corner all pa=geson the website. =C2=A0From the pull request description: "It essentially =turnsthe website into a moderated wiki. How it works is for each page it links=toa 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." It's meant for simple changes (typos, rewording stuff, minor bugs in code examples, etc.). I got the idea after using the GitHub online editor myse=lfto make website and Phobos documentation change pull requests and finding=itto be very easy way to contribute. Even people who are unfamiliar with gi=tcan use it. Andrei seemed to like it when I showed him but asked me to get Walter and whoever else's opinions on it before he'd be willing to merged it. You can try a live demo here: http://gnuk.net/d/index.html Clicking the button will open the appropriate file in an editor on GitHub=.Feel free to click the button to see what the editor is like. Nothing happens until you choose to submit your changes at which point it lets yo=uenter a pull request description, then it finally makes the request. This would probably have been difficult to implement if it weren't for Dd=ocso +1 for Ddoc. Regards, Brad AndersonSeems ok, though the styling isn't amazing, maybe tone the size of the buttons down. Also, Github does not exactly give a useful message when you aren't logged in (404), but that isn't your fault. -- James Miller
Mar 15 2012
On 16/03/2012 04:27, James Miller wrote:On 16 March 2012 17:14, Brad Anderson<eco gnuk.net> wrote:I think it looks fine and it's a great idea. At least for those of us with git hub accounts. -- My enormous talent is exceeded only by my outrageous laziness. http://www.ssTk.co.ukI have a pending pull request <https://github.com/D-Programming-Language/d-programming-language.org/pull/98> which adds an "Improve this page" button to the upper right corner all pages on the website. From the pull request description: "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." It's meant for simple changes (typos, rewording stuff, minor bugs in code examples, etc.). I got the idea after using the GitHub online editor myself to make website and Phobos documentation change pull requests and finding it to be very easy way to contribute. Even people who are unfamiliar with git can use it. Andrei seemed to like it when I showed him but asked me to get Walter and whoever else's opinions on it before he'd be willing to merged it. You can try a live demo here: http://gnuk.net/d/index.html Clicking the button will open the appropriate file in an editor on GitHub. Feel free to click the button to see what the editor is like. Nothing happens until you choose to submit your changes at which point it lets you enter a pull request description, then it finally makes the request. This would probably have been difficult to implement if it weren't for Ddoc so +1 for Ddoc. Regards, Brad AndersonSeems ok, though the styling isn't amazing, maybe tone the size of the buttons down. Also, Github does not exactly give a useful message when you aren't logged in (404), but that isn't your fault. -- James Miller
Mar 16 2012