diff --git a/site/source/_static/favicon.ico b/site/source/_static/favicon.ico index b84fec3..d80e03d 100644 Binary files a/site/source/_static/favicon.ico and b/site/source/_static/favicon.ico differ diff --git a/site/source/_static/logo.png b/site/source/_static/logo.png index 63e10bd..1ce3981 100644 Binary files a/site/source/_static/logo.png and b/site/source/_static/logo.png differ diff --git a/site/source/developer-docs/index.rst b/site/source/developer-docs/index.rst index 9261c41..4490f0d 100644 --- a/site/source/developer-docs/index.rst +++ b/site/source/developer-docs/index.rst @@ -12,6 +12,15 @@ Developer Docs
+.. topic-box:: + :title: Listing a Service + :link: submission + :icon: scylla-icon scylla-icon--contact-us + :class: large-4 + :anchor: Submit + + The process for submitting a service to the Community Registry + .. topic-box:: :title: Service Packaging :link: packaging @@ -48,6 +57,7 @@ Developer Docs :maxdepth: 1 :hidden: + submission packaging specification/index advanced/index \ No newline at end of file diff --git a/site/source/developer-docs/packaging.rst b/site/source/developer-docs/packaging.rst index 5efb642..ad0ffdf 100644 --- a/site/source/developer-docs/packaging.rst +++ b/site/source/developer-docs/packaging.rst @@ -299,6 +299,10 @@ The following files should be included in the service wrapper repository: - `Example MAKEFILE `_ +- ``prepare.sh`` + + - A script that setups up the build environment for a Debian system so that Start9 can verify the build process upon submission. + - ``Dockerfile`` - A recipe for service creation @@ -401,7 +405,7 @@ Testing Submission and Distribution =========================== -The ``s9pk`` file can be uploaded for distribution to any website, repository, or marketplace. You can also submit your package for publication consideration on a Start9 Marketplace by emailing us at submissions@start9labs.com or by contacting us in one of our `community channels `_. Please include a link to the wrapper repository with a detailed README in the submission. +The ``s9pk`` file can be uploaded for distribution to any website, repository, or marketplace. You can also submit your package for publication to the Community Registry by following the :ref:`submission process `. Advanced configuration ====================== diff --git a/site/source/developer-docs/submission.rst b/site/source/developer-docs/submission.rst new file mode 100644 index 0000000..ba915b4 --- /dev/null +++ b/site/source/developer-docs/submission.rst @@ -0,0 +1,31 @@ +.. _community-submission: + +============================ +Community Submission Process +============================ + +**The following must be completed for initial publication as well as every new version of a service** + +* The source code of the service wrapper and its upstream application must be public (source available) +* Send an email to submissions@start9.com containing a link to your polished service wrapper repository +* Start9 creates a snapshot of the repository +* Start9 reviews the codebase, inspecting for completeness and signs of foul play +* Start9 builds the service on our Debian build box (``prepare.sh`` and ``make.s9pk``). Start9 will not spend time fighting build errors or debugging. If your script does not produce a production build on first try, we will reply with the relevant error so you can fix it. +* Start9 installs and tests the service on a StartOS machine. Start9 will NOT test or judge the service itself, only that it runs smoothly and safely on StartOS, including: + + * Marketplace listing: the service must include all required metadata fields and valid links + * Install/Uninstall: the service must install and uninstall smoothly + * Instructions: if the service offers Instructions, they must display without error + * Properties: if the service offers Properties, they must display without error + * Config: if the service offers Config, it must function without error + * Dependencies: if the service depends on another service(s), it must properly utilize the StartOS dependency management system + * Actions: if the service offers Actions, they must run without error + * Health Checks: if the service offers Health Checks, they must display and run without error + * Interfaces: the service must offer at least one interface, otherwise there is no way to use it + * Logs: the logs page must display without error + * Compatibility: the service must run smoothly alongside the entire set of services on the Start9 Registry on a low resource device: think Raspberry PI (8GB) or an equivalent x86 machine + * Backup/Restore: the service must successfully backup and restore + +Upon satisfying all the above criteria, Start9 will publish the s9pk to the Community Beta Registry and send you an email to confirm acceptance. Except in emergency situations, we highly recommend that you leave your service on Beta for a couple of days, such that it can be tested by your own testers plus anyone else who enjoys testing new releases. This will maximize the probability that any bugs will be caught before shipping to production. + +When you are ready to publish to production, reply to the email, instructing Start9 to publish it. A simple "ship it" will do fine. diff --git a/site/source/user-manual/service-guides/vaultwarden/bitwarden-client-setup.rst b/site/source/user-manual/service-guides/vaultwarden/bitwarden-client-setup.rst index 651c77d..6ef9c95 100644 --- a/site/source/user-manual/service-guides/vaultwarden/bitwarden-client-setup.rst +++ b/site/source/user-manual/service-guides/vaultwarden/bitwarden-client-setup.rst @@ -13,8 +13,6 @@ Browser Extension .. group-tab:: Tor - Browser Extension - ----------------- If connecting via Tor (i.e using the .onion address) the Bitwarden browser extension will only work with a Tor enabled browser. You can use Firefox (recommended), Tor Browser or Brave Browser. #. If you choose Firefox, you will need to :ref:`setup Tor on your device ` and :ref:`configure Firefox to use Tor `. If using Brave you will just need to :ref:`setup Tor on your device `. With Tor Browser, everything will just work right out of the box. @@ -197,9 +195,6 @@ Desktop Clients .. collapse:: Linux - Linux - ===== - First, be sure to get Tor :ref:`running on your system `. #. Install Bitwarden either by using a package manager like **apt** (we recommend against using **snap**) or download it from `here `_. @@ -212,9 +207,6 @@ Desktop Clients .. collapse:: Mac - Mac - === - .. tabs:: .. group-tab:: Tor diff --git a/sphinx-scylladb-theme b/sphinx-scylladb-theme index 785372a..197de85 160000 --- a/sphinx-scylladb-theme +++ b/sphinx-scylladb-theme @@ -1 +1 @@ -Subproject commit 785372a546b1c83f61d63665b57f67be6ca1fbbb +Subproject commit 197de852bd61805f0662654d106f28e7539a6ad2