I created a repo on Github to play with Github Pages. I copied the landing page for the wiki[1], and the results are definitely improved.[2]
Making the page more useful seems to require learning Jekyll or something. That’s more time than I have right now. If someone who knows this stuff better than I do want’s to take a stab at this, please let me know… [1]https://cwiki.apache.org/confluence/display/FLEX/FlexJS [2]http://flex-extras.github.io/flexjs-docs/ On Apr 18, 2016, at 12:21 AM, Harbs <harbs.li...@gmail.com> wrote: > Hi Andrew, > > Thanks so much for offering to help!!! > > We got a bit sidetracked talking about publishing technologies… ;-) > > The wiki is a pretty good starting point. > https://cwiki.apache.org/confluence/display/FLEX/Apache+Flex+Wiki > > It’s not as well organized as it could be, and there’s huge gaps in the info > you can find there, but it has somewhat of an outline and there’s a lot of > info there (at least to get started). > > On Apr 14, 2016, at 12:38 AM, Andrew Wetmore <cottag...@gmail.com> wrote: > >> I have good writing skills and have headed doc teams for software companies >> large and small. I have built doc platforms with Madcap Flare and other >> tools, but when I am working on a shoestring I prefer HelpScribble ( >> https://www.helpscribble.com/). I would be glad to help with this, >> especially if someone could point me to the existing documentation and help >> me develop a table of contents to populate. >> >> a >> >> On Wed, Apr 13, 2016 at 5:09 PM, Harbs <harbs.li...@gmail.com> wrote: >> >>> Documentation on the Flex SDK is pretty mature. You can find just about >>> anything you want on the web. >>> >>> FlexJS has next to nothing. As things are ramping up with FlexJS, there is >>> more an more functionality buried here in the dev list. I know I tend to be >>> really bad at documentation. Even if we were perfect about ASDoc comments >>> in the source code, that only helps for API documentation. Beyond that we >>> have a strong need for general usage documentation. This includes general >>> background, workflow, component usage, compiler arguments, IDEs, >>> contribution, integrating third party libraries, etc. Do we have anyone >>> subscribing to the list who has good writing skills who might want to take >>> on some of this? Does anyone have a good documentation platform to display >>> and help people find the info easily. (No. I don’t think the wiki is a good >>> platform for that.) I think Angular has a good documentation site[1]. (Of >>> course they probably had a team dedicated to writing it.) >>> >>> Thoughts? >>> >>> Harbs >>> >>> [1]https://docs.angularjs.org/guide >> >> >> >> >> -- >> Andrew Wetmore >> >> http://cottage14.blogspot.com/ >
