I have not forgotten "Royale in a Week", the reworking of "Flex in a Week" which I undertook to do. Will be working on that.
On Tue, Oct 1, 2019 at 2:37 PM Alex Harui <aha...@adobe.com.invalid> wrote: > The showcase would be great, but if it is easier/faster to simply have a > page of links to blogs of our committers like you and Harbs that just > contain a paragraph or two about how Royale has helped, that might be a > good place to start. > > -Alex > > On 10/1/19, 10:02 AM, "Carlos Rovira" <carlosrov...@apache.org> wrote: > > Hi Alex, > > El mar., 1 oct. 2019 a las 17:50, Alex Harui (<aha...@adobe.com.invalid > >) > escribió: > > > Thanks for working on the docs. > > > > Beyond the docs, what I would most like to see is "success > stories". I > > keep thinking it would help if it was easier for folks to read about > how > > Royale has helped. > > > > You refer to "showcase" page? > > https://nam04.safelinks.protection.outlook.com/?url=https%3A%2F%2Froyale.apache.org%2Fshowcase%2F&data=02%7C01%7Caharui%40adobe.com%7C2738afd6ca5c4c4807bf08d746912887%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637055461576181142&sdata=%2BN%2FcdilLG3C%2F2wPoJHWts04%2FxO0%2BVDRlqtW%2Bw%2BMrh9I%3D&reserved=0 > I still has that on my plate. I have to plan the info to showcase and > post > so people can submit about it > But yes is one of the important pieces to work on. I'll try to get > over it > soon. > > thanks > > > > My 2 cents, > > -Alex > > > > On 10/1/19, 3:54 AM, "Andrew Wetmore" <cottag...@gmail.com> wrote: > > > > This is great progress! > > > > I think one other area where we are still very thin is on using > > RoyaleUnit > > for testing. > > > > On Tue, Oct 1, 2019 at 6:56 AM Carlos Rovira < > carlosrov...@apache.org> > > wrote: > > > > > Hi, > > > > > > about latest changes in docs done is latest months. This is a > > summary of > > > the work done (still in progress at some points): > > > > > > About layout, search and usability: > > > > > > * Now we have a more polished layout that should work right on > > desktop, > > > tablet and mobile, making more easy for new users coming to > Royale > > learn > > > about it > > > * The sidebar menu will show on the right as normal in tablet > and > > desktop. > > > In mobile shows a button on the right side that make the menu > slide > > from > > > the right > > > * Now we have search functionality implemented thanks to > Algolia > > search. > > > The index is crawled every 24h. Take into account if you make > some > > change > > > and don't see it when searching as you upload the change. > > > * Main menu now turns to dropdown if there's no enough room to > show > > it > > > horizontally > > > > > > About content: > > > > > > * Added global styles for better readability and support of > most of > > the > > > markdown options and highlighting of code (specially for AS3 > and > > MXML) > > > * Now all pages has "description" and "permalink" in the head > > section to > > > improve sharing and searching on internet. Remember to add this > > lines so we > > > make all navigation consistent with the rest of pages. If > someone > > notice a > > > page without this, please add it or report it. > > > * Added metadata for sharing in social networks more easily > > capturing the > > > previous point plus screenshot and name. > > > * I tried to bring pages to the index that was still missing > so we > > have > > > most of the overall structure in place. I'm pretty sure > there's still > > > missing concepts and things to bring to the docs, so keep your > eyes > > open to > > > see what could still be missing and report it or add yourself. > > > * Notice that some of that content is still a page mostly > empty and > > waiting > > > to be filled. You're all invited to do so, just let others know > > about it to > > > avoid duplicate efforts. > > > * For Component Sets, I started to create a page per component > where > > we add > > > the most needed info to start with the component. It then > refers to > > ASDocs > > > for a full spec and access to all classes. I'm working on > Jewel. > > Others are > > > invited to use Jewel finished pages and use it as template for > Basic, > > > MXRoyale and other sets, and/or create new ones for components > that > > are not > > > similar and there's no counterpart on Jewel. > > > * I added live content on Jewel components, since visual > running > > examples > > > are very powerful. > > > * I added live example on the GitHub tutorial app. > > > * I added many cross link references between Royale-docs, blog > > examples and > > > ASDocs pages. Content must be in only one place but that > content > > should be > > > linked with the rest of royale contents in our network. > > > * I tried to format all the pages I could to get most of the > new > > visuals > > > created, but I'm sure threr's still content to format, we can > do this > > > between all here, and anyone coming to Royale and browse > content is > > invited > > > to help in this point as well to submit more content to be > reviewed > > and > > > added. > > > * I refactored all license pages to make all consistent with > one > > style. > > > > > > To Help: > > > > > > I think there's many content already done and formatted in the > right > > way to > > > make others be able to add content that aligns to the rest of > the doc > > > pages. Andrew and I are here to help to give the finished > results > > that > > > conform to actual specs. > > > > > > There's still many things to do to get a full docs site. This > is the > > list > > > of things I see: > > > > > > * Fill Features and concepts pages still empty (View States, > Data > > Binding, > > > RPC methods pages, ....). I think this can be the most > important > > ones since > > > are core concepts in Royale. > > > * Complete Jewel and other sets reference pages. Very > important for > > people > > > coming. Here I plan to add for Jewel "style specs" too as > someone > > mentioned > > > some days ago, and I think this will be a very good idea. > > > * Add Crux documentation, that should come in part from swiz > > framework docs > > > > > > What more things you still think are missing? > > > > > > Thanks > > > > > > > > > -- > > > Carlos Rovira > > > > > > https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fabout.me%2Fcarlosrovira&data=02%7C01%7Caharui%40adobe.com%7C2738afd6ca5c4c4807bf08d746912887%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637055461576181142&sdata=kYfh67uUCVIqPA%2FD6YIV%2FpyVOgOg5dyr0p8hCq1TBY4%3D&reserved=0 > > > > > > > > > -- > > Andrew Wetmore > > > > > > > https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fcottage14.blogspot.com%2F&data=02%7C01%7Caharui%40adobe.com%7C2738afd6ca5c4c4807bf08d746912887%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637055461576191136&sdata=a%2BX%2F%2BlO242%2BqVeUDd7CsUOCqyoPeyc2bwiL3xjFpM4g%3D&reserved=0 > > > > > > > > -- > Carlos Rovira > > https://nam04.safelinks.protection.outlook.com/?url=http%3A%2F%2Fabout.me%2Fcarlosrovira&data=02%7C01%7Caharui%40adobe.com%7C2738afd6ca5c4c4807bf08d746912887%7Cfa7b1b5a7b34438794aed2c178decee1%7C0%7C0%7C637055461576191136&sdata=QMLoJ4WGOdDHq24JEMJekkMwEuXT1A5Y8lDkXzB%2F07k%3D&reserved=0 > > > -- Andrew Wetmore http://cottage14.blogspot.com/
