wildaid / wildaid.github.io Goto Github PK

Add alt-text tags to the Create Boarding List Chart page.

Page exists at: https://wildaid.github.io/charts/2020/06/12/Boardings-List.html
In the code at: _posts/build_charts/2020-06-12-Boardings-List.md

A brief guide to alt-text tags can be found in our style guide at https://wildaid.github.io/style/2020/10/02/Alt-Text.html

Add alt-text tags to the Create Compliance Charts - Numbers page.

Page exists at: https://wildaid.github.io/charts/2020/06/12/Create-Compliance.html
In the code at: _posts/build_charts/2020-06-12-Create-Compliance.md

A brief guide to alt-text tags can be found in our style guide at https://wildaid.github.io/style/2020/10/02/Alt-Text.html

Add alt-text tags to the Create Map page.

Page exists at: https://wildaid.github.io/charts/2020/06/13/Create-Map.html
In the code at: _posts/build_charts/2020-06-13-Create-Map.md

A brief guide to alt-text tags can be found in our style guide at https://wildaid.github.io/style/2020/10/02/Alt-Text.html

Developers shouldn't have to build an entire infrastructure just to test some changes. A sandbox solution has been built, let's document it.

Also let's add the code of conduct information to the README and the docs.

Add alt-text tags to the build charts overview and the build and deploy to test charts pages.

Build charts overview:
Page exists at: https://wildaid.github.io/charts/2020/06/11/Build-Charts.html
In the code at: _posts/build_charts/2020-06-11-Build-Charts.md

Build and Deploy to Test, first time
Page exists at: https://wildaid.github.io/charts/2020/06/12/Test-Charts.html
In the code at: _posts/build_charts/2020-06-12-Test-Charts.md

Build and Deploy to Test, generic
Page exists at: https://wildaid.github.io/charts/2020/06/14/Test-Charts.html
In the code at: _posts/build_charts/2020-06-14-Test-Charts.md

A brief guide to alt-text tags can be found in our style guide at https://wildaid.github.io/style/2020/10/02/Alt-Text.html

Describe the bug

Using O-FISH on Web ends unexpectedly after:

The web application is designed for administrators back in the office to look at all the boarding information.
Using the web application:

To Reproduce

Visit https://wildaid.github.io/useWeb/.

Expected behavior

There should be links to pages with further info including screenshots (similar to Using O-FISH on Android):

» Logging in
» Home Screen

Desktop (please complete the following information):

• OS: macOS
• Browser: Chrome
• Browser Version: 85.0.4183.121

Add alt-text tags to the Embed Boarding List Chart page.

Page exists at: https://wildaid.github.io/charts/2020/06/12/Embed-Boardings-List.html
In the code at: _posts/build_charts/2020-06-12-Embed-Boardings-List.md

A brief guide to alt-text tags can be found in our style guide at https://wildaid.github.io/style/2020/10/02/Alt-Text.html

Add alt-text tags to the Android usage pages at https://wildaid.github.io/useAndroid/ (there are only 2 right now).

Pages exists at: https://wildaid.github.io/useAndroid/
In the code at:
_posts/use/2020-07-01-LoginA.md
_posts/use/2020-07-01-HomeScreenA.md

A brief guide to alt-text tags can be found in our style guide at https://wildaid.github.io/style/2020/10/02/Alt-Text.html

Add alt-text tags to the iOS usage pages at https://wildaid.github.io/useiOS/ (there are only 3 right now).

Page exists at: https://wildaid.github.io/useiOS/
In the code at:
_posts/use/2020-08-01-LoginI.md
_posts/use/2020-08-01-HomeScreenI.md
_posts/use/2020-08-13-FeedbackI.md

A brief guide to alt-text tags can be found in our style guide at https://wildaid.github.io/style/2020/10/02/Alt-Text.html

Add alt-text tags to the build foundation pages (0-3).

In the code at:
_posts/build_fdn/2020-06-09-Atlas-Database.md
_posts/build_fdn/2020-06-09-Atlas-Database-config.md
_posts/build_fdn/2020-06-09-Data-Import.md
_posts/build_fdn/2020-06-09-Create-Realm.md

On the web at:
https://wildaid.github.io/foundation/2020/06/09/Atlas-Database.html
https://wildaid.github.io/foundation/2020/06/09/Atlas-Database-config.html
https://wildaid.github.io/foundation/2020/06/09/Data-Import.html
https://wildaid.github.io/foundation/2020/06/09/Create-Realm.html

A brief guide to alt-text tags can be found in our style guide at https://wildaid.github.io/style/2020/10/02/Alt-Text.html

Add alt-text tags to the Charts Setup page.

Page exists at: https://wildaid.github.io/charts/2020/06/12/Charts-Setup.html
In the code at: _posts/build_charts/2020-06-12-Charts-Setup.md

A brief guide to alt-text tags can be found in our style guide at https://wildaid.github.io/style/2020/10/02/Alt-Text.html

Describe the bug
If you try to set up the repo locally and visit localhost:4000, you get 404 page and none of the URLs work. The problem was introduced with ccf34de#diff-ecec67b0e1d7e17a83587c6d27b6baaaa133f42482b07bd3685c77f34b62d883R6 where the baseURL should be empty instead of .

To Reproduce
Steps to reproduce the behavior:

1. Set up the project locally.
2. Run bundle exec jekyll serve.
3. Visit localhost:4000
4. Get 404 page

Expected behavior
The site should run locally when baseURL . is replaced with empty space. Not sure about the deployed version though.

Screenshots

Desktop (please complete the following information):

• OS: Ubuntu
• Browser: Chrome

Use https://github.com/gjtorikian/html-proofer.

This is an example with Travis but can be extrapolated:
https://jekyllrb.com/docs/continuous-integration/travis-ci/

Add alt-text tags to the troubleshooting page:

Page exists at: https://wildaid.github.io/charts/2020/06/14/TroubleshootingCharts.html
In the code at: _posts/build_charts/2020-06-14-TroubleshootingCharts.md

A brief guide to alt-text tags can be found in our style guide at https://wildaid.github.io/style/2020/10/02/Alt-Text.html

Add alt-text tags to the web build pages (there are 3 of them).

In the code at: _posts/build_web/
Pages on the web are:
https://wildaid.github.io/web/2020/06/09/Prepare-Web-App.html
https://wildaid.github.io/web/2020/06/09/Build-Web-App.html
https://wildaid.github.io/web/2020/06/09/Test-Web-App.html

A brief guide to alt-text tags can be found in our style guide at https://wildaid.github.io/style/2020/10/02/Alt-Text.html

Add alt-text tags to the Create Compliance Charts - Percentage page.

Page exists at: https://wildaid.github.io/charts/2020/06/12/Create-Compliance2.html
In the code at: _posts/build_charts/2020-06-12-Create-Compliance2.md

A brief guide to alt-text tags can be found in our style guide at https://wildaid.github.io/style/2020/10/02/Alt-Text.html

Add alt-text tags to the Create Compliance Charts - Donut page.

Page exists at: https://wildaid.github.io/charts/2020/06/12/Create-Compliance-Donut.html
In the code at: _posts/build_charts/2020-06-12-Create-Compliance-Donut.md

A brief guide to alt-text tags can be found in our style guide at https://wildaid.github.io/style/2020/10/02/Alt-Text.html

Setting up a sandbox server requires special knowledge, and should be documented to overcome institutional knowledge barriers.

Describe the solution you'd like
Documentation so a reasonably techie administrator can set up a sandbox instance.

Notes:
In the web app, the 'sandbox: true' flag needs to be set in the config.js file so the new_dev_user form is activated.
In the realm app, add developerMode value (under Realm -> Values & Secrets)
In the realm app, under Rules -> mongodb-atlas -> Agency Admin role, edit the role and check "Insert Documents".

Add alt-text tags to the build foundation pages (4-7).

In the code at:
_posts/build_fdn/2020-06-09-Realm-API-Key.md
_posts/build_fdn/2020-06-09-Setup-Commandline-for-Realm-Import.md
_posts/build_fdn/2020-06-09-Import-Realm-Code.md
_posts/build_fdn/2020-06-09-Connect-Realm-With-Data.md

On the web at:
https://wildaid.github.io/foundation/2020/06/09/Realm-API-Key.html
https://wildaid.github.io/foundation/2020/06/09/Setup-Commandline-for-Realm-Import.html
https://wildaid.github.io/foundation/2020/06/09/Import-Realm-Code.html
https://wildaid.github.io/foundation/2020/06/09/Connect-Realm-With-Data.html

A brief guide to alt-text tags can be found in our style guide at https://wildaid.github.io/style/2020/10/02/Alt-Text.html

Currently the documentation is a jekyll site using markdown/html, blog posts, and the just-the-docs theme.

What we need:

• Accessibility - images don't have alt tags, for example, but I'm sure there are tons of accessibility issues we're not thinking of.

• Cross-documentation linking that does not break if a detail is changed (e.g. moved to a different category)

• Easy separation of tracks - one for end-user documentation, and one for developer documentation

• Multi-media support - at the very least, text formatting, images and gifs. Movie support is a plus

• Something fully supported by github - the theme is not supported and every page build gives a warning.

• Workflow capabilities - e.g. developers can take different paths, like building the foundation and then building charts, or building the foundation and then building the iOS app. Right now we are using different blog categories and blog post dates to order and separate the workflows, which is suboptimal.

• Easy to update and contribute to - this is an open source project, after all! Changes may be rapid and we want to make sure we can update stale items.

Converting the documentation is a bigger project, and is blocked by this.