Hi Andrew, So I just pushed more stubs for the Create An Application section. As I was doing so, I started thinking that what you expect in that section is different from what I'm interested in working on. It isn't that we don't need that section, but it appears that you want to address application development as a general topic, discussing the design phase, and maintenance phases, etc.
What I want to write is a "Royale in 10 minutes". Sort of a tutorial for building something more than a Hello World, and discuss some "under-the-hood" things like how the app starts up, how you know the app is ready, calling a web service, stuff like that. If you agree we want such a thing, where would it go? Also, we have to be a bit careful about terminology. The reason I initially thought that I would do the "Royale in 10 minutes" in the "Create an Application" section is because one subsection is titled "Application Lifecycle". To me, that meant the under-the-hood lifecycle of an application like what its entry point is, what gets initialized first, etc. I'm tempted to rename the current "Application Lifecycle" to "Application Development Phases" so I can use "Lifecycle" for the under-the-hood section. Or is there a better name for how an application starts up? I'm going to go spend some time on ASDoc while we figure this out. Also, at some point, we should sweep through all of the files and add the Apache header to them. I did it in "Create an Application.md" to make sure it didn't pollute the output. I didn't do the sweep now since I didn't know if you have files under edit. I'm not sure what hours you are working on this, so we should just pick a time where we have everything committed and do a sweep. I could do it on my Sunday night on the US west coast. Thoughts? Alex On 1/24/18, 3:33 AM, "Andrew Wetmore" <cottag...@gmail.com> wrote: >Hi! > >Yes, I feel like a real committer now. > >I am going to migrate some material from the FlexJS documentation to see >what that experience is like. I am going to draw from "Overview" [1] ><https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fcwiki.ap >ache.org%2Fconfluence%2Fpages%2Fviewpage.action%3FpageId%3D34013930&data=0 >2%7C01%7Caharui%40adobe.com%7C2c1e3998a2a74e3f711008d5631e4dff%7Cfa7b1b5a7 >b34438794aed2c178decee1%7C0%7C0%7C636523904169740086&sdata=xvrjFAbcWsrqNxC >NLM8f9si466Td%2F1LWp2lkDiVKG5U%3D&reserved=0> >to populate both "High level view" and the third-level "Migrate from Flex" >under "Create an application". > >I have added a note about the "front matter" to the README file. > >Will take a look at your changes to the ToC structure before adding other >page entries. > >This is fun! > > > > > > > >[1] >https://na01.safelinks.protection.outlook.com/?url=https%3A%2F%2Fcwiki.apa >che.org%2Fconfluence%2Fpages%2Fviewpage.action%3FpageId%3D34013930&data=02 >%7C01%7Caharui%40adobe.com%7C2c1e3998a2a74e3f711008d5631e4dff%7Cfa7b1b5a7b >34438794aed2c178decee1%7C0%7C0%7C636523904169740086&sdata=xvrjFAbcWsrqNxCN >LM8f9si466Td%2F1LWp2lkDiVKG5U%3D&reserved=0 > >On Wed, Jan 24, 2018 at 3:50 AM, Alex Harui <aha...@adobe.com.invalid> >wrote: > >> Hi Andrew, >> >> Looks like your commit privileges are working. >> >> I think we need to coordinate so we don't step on each others toes. I'm >> thinking I will add a bit to Features and Concepts so it links to its >> children (AS3, MXML, PAYG, Strand and Beads) so I can make sure the >> third-level of the TOC works, then move on to Create An Application as >> that's where I want to spend more time building out some sort of app "in >> 10 minutes". Ideas for what to put in that app are welcome from >>anybody. >> I don't want it to just be "Hello World". Maybe hit the network or a >>JSON >> file. Or maybe I'll spend some time on ASDoc instead and come back to >> this later. >> >> Couple of other things: >> I reviewed your commits. All .MD files need the "Front Matter". See >>one >> of the .MD files I did and copy and modify the first lines with the >>dashed >> lines. See Jekyll doc to understand it better. >> >> I just pushed a significant change to the pattern for new TOC entries in >> docpage.html so please sync up before making more changes to that file. >> >> The main Welcome page is currently in index.md, not in Welcome/index.md. >> The TOC does not point to Welcome/index.html. I'm not sure that's right >> so we might need to tweak how that works. A related issue is that I >>think >> you wanted only the top-level TOC items visible when you first landed at >> the doc, but that means that clicking on a TOC link doesn't expand to >>show >> child pages in the TOC, otherwise the Welcome would be expanded and show >> High Level and Features and push Get Started further down. If we do >>have >> a different /index.html as the landing page and Welcome in the TOC opens >> Welcome/index.html, then we can have clicking a TOC link show the child >> pages in the TOC. >> >> Another thing on my to-do list is to figure out how to use media query >>to >> hide the TOC behind a menu button when the screen isn't wide enough. >>Not >> sure how important that is at this time. >> >> Thoughts? >> -Alex >> >> >> > > >-- >Andrew Wetmore > >https://na01.safelinks.protection.outlook.com/?url=http%3A%2F%2Fcottage14. >blogspot.com%2F&data=02%7C01%7Caharui%40adobe.com%7C2c1e3998a2a74e3f711008 >d5631e4dff%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C636523904169740086 >&sdata=pI4x82%2BRdqE6DGronsdMdDegPBfUp4tB0zjPCdaTzBs%3D&reserved=0
