Reorganise site into Consumer and Contributor spaces.

1. Create indexes for each space
2. Link to indexes from home page
3. Rename internal structure to reflect new spaces.
4. Move automation doc from contributor to consumer.
5. Simplfy home page.
6. Add links to issues and bugzilla for README and home page.
This commit is contained in:
Emily Toop 2019-05-31 14:08:42 +01:00
Родитель 698206de52
Коммит bb9f9fa5ca
11 изменённых файлов: 83 добавлений и 35 удалений

Просмотреть файл

@ -1,3 +1,9 @@
This GitHub repository contains the documentation for [GeckoView][8]. If you are looking for the code for GeckoView you can find it at [Mozilla Central][9].
If there is documentation that you feel is missing, or an existing document doesn't cover the aspect that you are looking for, please request it by [raising an issue][10].
If you have a GeckoView bug that you want to raise, please do so on our [Bugzilla][11].
## Get Started with GeckoView ## Get Started with GeckoView
* [GeckoView Quick Start Guide][1] * [GeckoView Quick Start Guide][1]
@ -21,10 +27,14 @@
You can read more about GeckoView on the [wiki](https://wiki.mozilla.org/Mobile/GeckoView). You can read more about GeckoView on the [wiki](https://wiki.mozilla.org/Mobile/GeckoView).
[1]:docs/geckoview-quick-start.md [1]:https://geckoview.dev/consumer/docs/geckoview-quick-start
[2]:javadoc/mozilla-central/org/mozilla/geckoview/doc-files/CHANGELOG.md [2]:https://geckoview.dev/javadoc/mozilla-central/org/mozilla/geckoview/doc-files/CHANGELOG.md
[3]:tutorials/geckoview-quick-start.md [3]:https://geckoview.dev/contributor/geckoview-quick-start.md
[4]:tutorials/mc-quick-start.md [4]:https://geckoview.dev/contributor/mc-quick-start.md
[5]:tutorials/contributing-to-mc.md [5]:https://geckoview.dev/contributor/contributing-to-mc.md
[6]:tutorials/native-debugging.md [6]:https://geckoview.dev/contributor/native-debugging.md
[7]:docs/web-extensions.md [7]:https://geckoview.dev/consumer/docs/web-extensions.md
[8]:https://geckoview.dev
[9]:https://searchfox.org/mozilla-central/source/mobile/android/geckoview
[10]:https://github.com/mozilla/geckoview/issues
[11]: https://bugzilla.mozilla.org/enter_bug.cgi?product=GeckoView

Просмотреть файл

@ -1,9 +1,10 @@
--- ---
layout: default layout: default
title: Configuring GeckoView for Automation title: Configuring GeckoView for Automation
nav_order: 4
summary: How to set environment variables, Gecko arguments, and Gecko preferences for automation and debugging. summary: How to set environment variables, Gecko arguments, and Gecko preferences for automation and debugging.
tags: [GeckoView,Gecko,mozilla,android,WebView,mobile,debugging,automation,config,configuration,environment,variables,arguments,preferences] tags: [GeckoView,Gecko,mozilla,android,WebView,mobile,debugging,automation,config,configuration,environment,variables,arguments,preferences]
nav_exclude: true
exclude: true
--- ---
## Table of contents ## Table of contents
{: .no_toc .text-delta } {: .no_toc .text-delta }

Просмотреть файл

18
consumer/docs/index.md Normal file
Просмотреть файл

@ -0,0 +1,18 @@
---
layout: default
title: GeckoView Usage Documentation
nav_order: 3
---
# Usage Documentation
We are working on providing detailed usage documentation for all of GeckoView's most popular features. Here is what we have so far.
- [GeckoView Quick Start Guide](geckoview-quick-start):
Get GeckoView up and running inside your application.
- [Interacting with Web Content](web-extensions):
Writing Web Extensions, running content scripts and interacting with Javascript running in a web page.
- [Configuring GeckoView for Automation](automation):
Get GeckoView set up on your automation system.
If there is documentation that you feel is missing, or an existing document doesn't cover the aspect that you are looking for, please request it by raising an issue on our [documentation site](https://github.com/mozilla/geckoview/issues).

Просмотреть файл

@ -1,8 +1,9 @@
--- ---
layout: default layout: default
title: Interacting with Web content title: Interacting with Web content
nav_order: 3
summary: How to interact with Web content and register WebExtensions in GeckoView. summary: How to interact with Web content and register WebExtensions in GeckoView.
nav_exclude: true
exclude: true
--- ---
# Interacting with Web content and WebExtensions # Interacting with Web content and WebExtensions

Просмотреть файл

@ -1,9 +1,10 @@
--- ---
layout: default layout: default
title: Mozilla Central Contributor Guide title: Mozilla Central Contributor Guide
nav_order: 7
summary: Guide to setting up as a contributor to mozilla-central. summary: Guide to setting up as a contributor to mozilla-central.
tags: [GeckoView,Gecko,mozilla,android,WebView,mobile,mozilla-central,bug fix,submit,patch,arcanist,arc,moz-phab,phabricator] tags: [GeckoView,Gecko,mozilla,android,WebView,mobile,mozilla-central,bug fix,submit,patch,arcanist,arc,moz-phab,phabricator]
nav_exclude: true
exclude: true
--- ---
## Table of contents ## Table of contents
{: .no_toc .text-delta } {: .no_toc .text-delta }

Просмотреть файл

@ -1,9 +1,10 @@
--- ---
layout: default layout: default
title: GeckoView Contributor Guide title: GeckoView Contributor Guide
nav_order: 3
summary: Guide to setting up as a contributor to GeckoView. summary: Guide to setting up as a contributor to GeckoView.
tags: [GeckoView,Gecko,mozilla,android,WebView,mobile,mozilla-central,setup,get started,compile,build,deploy,bug fix,submit,patch,arcanist,arc,moz-phab,phabricator] tags: [GeckoView,Gecko,mozilla,android,WebView,mobile,mozilla-central,setup,get started,compile,build,deploy,bug fix,submit,patch,arcanist,arc,moz-phab,phabricator]
nav_exclude: true
exclude: true
--- ---
## Table of contents ## Table of contents
{: .no_toc .text-delta } {: .no_toc .text-delta }

19
contributor/index.md Normal file
Просмотреть файл

@ -0,0 +1,19 @@
---
layout: default
title: GeckoView Contributor Documentation
nav_order: 4
---
# Contributor Site
If you want to run GeckoView from code, or start contributing back to the project, here you will find resources to help you do that.
- [GeckoView Contributor Quick Start Guide](geckoview-quick-start): Get GeckoView set up for development.
- [Mozilla Central Quick Start Guide](mc-quick-start):
Get Mozilla Central set up for development.
- [Mozilla Central Contributor Guide](contributing-to-mc):
Get started as a contributor to Mozilla Central.
- [Guide to Native Debugging in Android Studio](native-debugging):
Set up Android Studio for debugging native code.
If there is documentation that you feel is missing, or an existing document doesn't cover the aspect that you are looking for, please request it by raising an issue on our [documentation site](https://github.com/mozilla/geckoview/issues).

Просмотреть файл

@ -1,9 +1,10 @@
--- ---
layout: default layout: default
title: Mozilla Central Quick Start title: Mozilla Central Quick Start
nav_order: 6
summary: Guide to setting up as a Git contributor to mozilla-central. summary: Guide to setting up as a Git contributor to mozilla-central.
tags: [GeckoView,Gecko,mozilla,android,WebView,mobile,mozilla-central,setup,compiling,mercurial,git-cinnabar] tags: [GeckoView,Gecko,mozilla,android,WebView,mobile,mozilla-central,setup,compiling,mercurial,git-cinnabar]
nav_exclude: true
exclude: true
--- ---
## Table of contents ## Table of contents
{: .no_toc .text-delta } {: .no_toc .text-delta }

Просмотреть файл

@ -1,9 +1,10 @@
--- ---
layout: default layout: default
title: Debugging Native Code title: Debugging Native Code
nav_order: 5
summary: How to set up native debugging for GeckoView using Android Studio. summary: How to set up native debugging for GeckoView using Android Studio.
tags: [GeckoView,Gecko,mozilla,android,WebView,mobile,debugging,native,android studio] tags: [GeckoView,Gecko,mozilla,android,WebView,mobile,debugging,native,android studio]
nav_exclude: true
exclude: true
--- ---
## Table of contents ## Table of contents
{: .no_toc .text-delta } {: .no_toc .text-delta }

Просмотреть файл

@ -6,6 +6,8 @@ summary: GeckoView, a webview from Mozilla specifically designed for Android bro
tags: [GeckoView,Gecko,mozilla,android,WebView,mobile,mozilla-central] tags: [GeckoView,Gecko,mozilla,android,WebView,mobile,mozilla-central]
--- ---
# Welcome to GeckoView
While Android offers a built-in WebView, it's not intended for building browsers, and many advanced Web APIs are disabled. Android's WebView is also a moving target: it's impossible know exactly which engine (and what version of that engine) will power a WebView on client devices. While Android offers a built-in WebView, it's not intended for building browsers, and many advanced Web APIs are disabled. Android's WebView is also a moving target: it's impossible know exactly which engine (and what version of that engine) will power a WebView on client devices.
In contrast, GeckoView is: In contrast, GeckoView is:
@ -14,34 +16,27 @@ In contrast, GeckoView is:
- **Self-Contained**: Because GeckoView is a standalone library that you bundle with your application, you can be confident that the code you test is the code that will actually run. - **Self-Contained**: Because GeckoView is a standalone library that you bundle with your application, you can be confident that the code you test is the code that will actually run.
- **Standards Compliant**: Like Firefox, GeckoView offers excellent support for modern Web standards. - **Standards Compliant**: Like Firefox, GeckoView offers excellent support for modern Web standards.
## Get Started with GeckoView ## Using GeckoView
* [GeckoView Quick Start Guide][1]
* [Quick Start Guide][1]
* [Usage Documentation][7]
## API Documentation ## API Documentation
* [Changelog][2] * [Changelog][2]
* [API](javadoc/mozilla-central/index.html) * [API][3]
## Get Started as a Contributor
* [GeckoView Contributor Quick Start Guide][3]
* [Mozilla Central Quick Start Guide][4]
* [Mozilla Central Contributor Guide][5]
* [Guide to Configuring GeckoView for Automation][6]
* [Guide to Native Debugging in Android Studio][7]
## More information ## More information
* [GeckoView Wiki](https://wiki.mozilla.org/Mobile/GeckoView) * [GeckoView Wiki][4]
* [GeckoView Source Code](https://searchfox.org/mozilla-central/source/mobile/android/geckoview) * [GeckoView Source Code][5]
* [This Site on GitHub](https://github.com/mozilla/geckoview/) * [Raise a bug on GeckoView code][8]
* [Raise a documentation bug][6]
[1]:docs/geckoview-quick-start [1]:consumer/docs/geckoview-quick-start
[2]:javadoc/mozilla-central/org/mozilla/geckoview/doc-files/CHANGELOG [2]:javadoc/mozilla-central/org/mozilla/geckoview/doc-files/CHANGELOG
[3]:tutorials/geckoview-quick-start [3]:javadoc/mozilla-central/index.html
[4]:tutorials/mc-quick-start [4]:https://wiki.mozilla.org/Mobile/GeckoView
[5]:tutorials/contributing-to-mc [5]:https://searchfox.org/mozilla-central/source/mobile/android/geckoview
[6]:tutorials/automation [6]:https://github.com/mozilla/geckoview/issues
[7]:tutorials/native-debugging [7]:consumer/docs/index
[8]: https://bugzilla.mozilla.org/enter_bug.cgi?product=GeckoView