On 27 January 2014 04:35, Michel Krämer <[email protected]>wrote:
> +1 > > I would love to contribute to the website. I don't know AsciiDoc's code > base very well, so contributing to that would make less sense, but on the > other hand I have quite some experience in web design. > At the moment the Asciidoc website is written in Asciidoc (see the "doc" directory for the sources). I'm not sure how much scope that gives you. On the other hand its my personal opinion that the user guide is more a programmers guide (sorry Stuart) being organised the way the program works, not in terms of doing end-user things. The most obvious thing is the macros section, the user needs to know that links, images etc are macros before they know which section to look in. Dan's suggestion of gh-pages sounds good, I have no experience using it, but a quick RTFM seems to suggest that it allows the pages to be generated to provide a static site that matches the last release. I would not want the "official" website to follow latest git, but to remain at last release. Or autogenerating them from a specified release tagged commit would be an alternative, but I didn't see that capability in my quick peruse. > > Also, who is taking care of pull requests? I made a request a couple of > weeks ago, just after I migrated the repo to GitHub. It's a fairly simple > change that just tidies up the readme file a bit. However, nobody has taken > care of the request. > So far I seem to be the only person who has indicated a willingness to do so. I'm just back from holidays, but hope to look at the PRs and other recent patch contributions soon. > > In fact, technically I have the rights to submit the request myself (as > I'm member of the AsciiDoc organisation). Since I'm rather new to this > community I'm just not sure if I would offend someone in doing so. Please > let me know what you think. > As I noted there will be periods when I simply won't have time to do much on Asciidoc for a while, so more volunteers are needed. As you say PR #1 is so simple, feel free to commit it. My general rule is to make a PR for contentious things, if nobody objects in a week or two, commit it. Cheers Lex > > Michel > > > Am 26.01.2014 03:24, schrieb Dan Allen: > >> Lex, >> >> I'm glad you bright this up. I'd really like to see the website hosted >> on GitHub Pages (either the gh-pages branch in the same repository or a >> dedicated repo). My philosophy is that site content should be treated >> just like code. >> >> I currently administer the .org domain names, so I can point them there >> if / when we decide to move it. >> >> -Dan >> >> On Jan 25, 2014 5:41 PM, "Lex Trotman" <[email protected] >> <mailto:[email protected]>> wrote: >> >> >> >> >> On 22 December 2013 03:17, Michel Krämer >> <[email protected] >> <mailto:[email protected]>> wrote: >> >> Dear all, >> >> AsciiDoc is now available on GitHub! >> https://github.com/asciidoc/__asciidoc >> >> <https://github.com/asciidoc/asciidoc> >> >> @Stuart: You may now make an official announcement, probably on >> the website!? >> >> >> Which raises the question, is Stuart happy to have the website >> continue on his servers? If so how do we get updates from the >> source in github to the website? Does anyone have alternate >> suggestions? >> >> >> Also I recommend adding the 'Fork me on GitHub' ribbon to the >> website: >> https://github.com/blog/273-__github-ribbons >> >> <https://github.com/blog/273-github-ribbons> >> >> >> Agree >> >> >> >> A description on how to contribute would also make it much >> easier for developers who would like to do so. >> >> >> Agree, we just need to do it :) >> >> >> What do you think? >> >> Cheers >> Lex >> >> Cheers, >> Michel >> >> >> Am 21.12.2013 11:59, schrieb Lex Trotman: >> >> Thanks Dan, >> >> I'm travelling with only limited internet access >> (essentially email) so >> can't help until I get back mid Jan. >> >> Cheers >> Lex >> >> -- >> You received this message because you are subscribed to the >> Google >> Groups "asciidoc" group. >> To unsubscribe from this group and stop receiving emails >> from it, send >> an email to asciidoc+unsubscribe@__googlegroups.com >> <mailto:asciidoc%[email protected]>. >> >> To post to this group, send email to >> [email protected] <mailto:[email protected]>. >> Visit this group at >> http://groups.google.com/__group/asciidoc >> <http://groups.google.com/group/asciidoc>. >> For more options, visit >> https://groups.google.com/__groups/opt_out >> <https://groups.google.com/groups/opt_out>. >> >> >> >> -- >> You received this message because you are subscribed to the >> Google Groups "asciidoc" group. >> To unsubscribe from this group and stop receiving emails from >> it, send an email to asciidoc+unsubscribe@__googlegroups.com >> <mailto:asciidoc%[email protected]>. >> >> To post to this group, send email to [email protected] >> <mailto:[email protected]>. >> Visit this group at http://groups.google.com/__group/asciidoc >> <http://groups.google.com/group/asciidoc>. >> For more options, visit >> https://groups.google.com/__groups/opt_out >> <https://groups.google.com/groups/opt_out>. >> >> >> >> -- >> You received this message because you are subscribed to the Google >> Groups "asciidoc" group. >> To unsubscribe from this group and stop receiving emails from it, >> send an email to [email protected] >> <mailto:asciidoc%[email protected]>. >> >> To post to this group, send email to [email protected] >> <mailto:[email protected]>. >> >> Visit this group at http://groups.google.com/group/asciidoc. >> For more options, visit https://groups.google.com/groups/opt_out. >> >> -- >> You received this message because you are subscribed to the Google >> Groups "asciidoc" group. >> To unsubscribe from this group and stop receiving emails from it, send >> an email to [email protected]. >> To post to this group, send email to [email protected]. >> Visit this group at http://groups.google.com/group/asciidoc. >> For more options, visit https://groups.google.com/groups/opt_out. >> > > -- > You received this message because you are subscribed to the Google Groups > "asciidoc" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To post to this group, send email to [email protected]. > Visit this group at http://groups.google.com/group/asciidoc. > For more options, visit https://groups.google.com/groups/opt_out. > -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/asciidoc. For more options, visit https://groups.google.com/groups/opt_out.
