commit | 5f880e4eb50601a98669f8365551003aec0d053a | [log] [tgz] |
---|---|---|
author | Andrew Wetmore <andrew@cottage14.com> | Sat Jul 13 17:53:36 2019 -0300 |
committer | GitHub <noreply@github.com> | Sat Jul 13 17:53:36 2019 -0300 |
tree | 189b083e2d8cfe71f134b4701955abcf0b9dbbbb | |
parent | f9a676a6232a3f5e1d91c1086905f395220aa0c4 [diff] |
Update testing.md added link to an article about test-driven development.
We have three main audiences:
We can't assume that everybody understands the conversational shorthand Flex veterans use. Write for a person of good will who is reading to find out, and who wants to get to the next needed nugget of knowledge soon so they can go and make progress on the app they are working on.
Each .md page starts with “front matter” structured like this:
--- # Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to You under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. layout: docpage title: README ---
Use HTML comments at the top of the document for any explanatory notes for the doc team (<!-- Not finished yet - Andrew -->
) and for provenance when adapting existing material for Royale purposes (<!-- Created by Peter Ent, modified by Tom Chiverton, as part of FlexJS documentation-->
).
%20
statements, and add the markdown specification. The file name should be “another-important-thing.md”, not “Another%20Important%20Thing.md”, “AnotherImportantThing.md”, or “Another_important_thing.md”. This is important for SEO, human readability, and readability by assistive devices.In the .md files, links have to be full paths without the leading slash. So to link to the published, HTML, version of /Welcome/Features/as3.md, you would use
[AS3](welcome/features/as3.html)
without the leading “/”. Links are case-sensitive, and you need to insert %20
for any space that appears in the target file's name. Check the guidance about file names, above.
When linking to locations not in the help-docs stack, including other pages in the Royale website, clicking the link should open a new browser window or tab so the reader does not lose their place in the help docs. MarkDown does not support the directive to open the link in a new window or tab, so use straight HTML for these links, like this:
<a href="https://flex.apache.org" target="_blank">Apache Flex</a>
Install Ruby+Devkit. Ruby is required to run Jekyll.
Install Jekyll.
If you want to provide a local configuration, copy _config.yml
to local_config.yml
.
To build the docs, run the following command:
jekyll build --config local_config.yml
The website will be rendered inside the _site
folder.
To browse the docs using built-in Jekyll server, run the following command:
jekyll serve
The website will be available at http://127.0.0.1:4000/royale-docs/
.