Hi Andrian, thanks for joining us. I think you're right, so for me is ok to start helping in docs and videos since is our main focus now.
Thanks and welcome to Apache Royale! :) El mié., 8 may. 2019 a las 9:16, Yishay Weiss (<yishayj...@hotmail.com>) escribió: > Hi Adrian and Welcome, > > > > These changes all sound good to me. > > > > Yishay > > > > ________________________________ > From: Adrian Szuszkiewicz <adrianszuszkiew...@gmail.com> > Sent: Tuesday, May 7, 2019 6:47:56 PM > To: dev@royale.apache.org > Subject: Royale Docs Changes Proposal > > Hi all :) > > Introduction > > My name is Adrian and together with Piotr I am preparing a set of video > tutorials about Moonshine IDE, Royale and ActionScript. I am completely new > to this technology stack and a few days ago I was reading Royale Docs for > the first time. There were a couple of things I found confusing about the > structure of the documentation. I believe that with a few minor changes to > the docs we can achieve more clarity. If the Team agrees I volunteer to do > the changes. Here’s what I propose: > > Merging Getting Started > > There are two pages with awfully similar titles and responsibilities: > > - > > Getting Started [https://royale.apache.org/getting-started/] reachable > from "Get Started" button on main Royale page > - > > Get started with Royale [ > https://apache.github.io/royale-docs/Get%20Started.html] reachable from > "Get Started" item in doc’s table of content. > > In my opinion, the existence of two Get Started pages is very confusing. If > you agree I’d like to: > > 1. > > Move all the content of Getting Started page to Get started with Royale > in > the docs > 2. > > Make Get Started button on main Royale page point to Get started with > Royale in the docs. > > > Renaming Links with Instructions > > On "Getting Started" page there are four links with instructions about how > to install and configure Royale in different editors. When I was reading > the docs for the first time I skipped those links because I thought they > only point to download locations, not the instructions. I’d like to rename > them as follows: > > - > > “Moonshine IDE” -> “Instructions for Moonshine IDE” > - > > “Visual Studio Code” -> “Instructions for Visual Studio Code” > - > > “Adobe Flash Builder” -> “Instructions for Adobe Flash Builder” > - > > “IntelliJ IDEA” -> “Instructions for IntelliJ IDEA” [this link is empty > but I’d keep it anyway] > > > Changing Menu Behavior > > The Table of Content menu on the right side in the docs behaves in a weird > way. When you click on an item it doesn't automatically expand. But when > you select your topic from the main text then it expands correctly showing > all its children. At first, I thought the menu was incomplete and > disjointed but then I realized it just doesn’t expand at right times. It > made me feel a little bit lost in the docs and track my journey through > them in the notepad. If you agree I’d like to fix expanding behavior. > > It's easier to conceptualize this in a video: > https://www.youtube.com/watch?v=GHzDnH8h6gE&feature=youtu.be > > > Have a great day, > > Adrian > -- Carlos Rovira http://about.me/carlosrovira
