mirror of
https://github.com/Start9Labs/documentation.git
synced 2026-03-26 02:11:55 +00:00
Maint/remove contributing (#373)
* Axe contribute section, improve alt registries page * Remove another link
This commit is contained in:
kn0wmad
@@ -1,44 +0,0 @@
|
||||
.. _content:
|
||||
|
||||
==============
|
||||
Create Content
|
||||
==============
|
||||
|
||||
.. tip:: If you aren't sure where to start, please reach out to the :ref:`Start9 Community<contact>`, we're happy to help!!
|
||||
|
||||
One of the most important things an individual can do to help the movement is to get the word out about sovereign computing and help others learn how to declare their own independence.
|
||||
|
||||
Feedback
|
||||
--------
|
||||
We thrive on user feedback!
|
||||
|
||||
Write reviews or blog posts on Medium, Substack, Reddit, Mastodon, Twitter, or others
|
||||
|
||||
It may not seem like it, but a single review can teach us a lot. Further, as these reviews add up, we can better understand pain points and popular requests.
|
||||
|
||||
Whether you just like our ethos, had a good experience with a support call, or want to do a full unboxing/test/review/how-to, ALL feedback is valuable and helps spread the message at the same time!
|
||||
|
||||
Notes:
|
||||
- Tag us!! We read them all, but we will not see them if they are not brought to our attention.
|
||||
- Give details. If you have no complaints, that's great, but please list something specific that you DO like.
|
||||
|
||||
Audio / Video Content
|
||||
---------------------
|
||||
Online A/V content is incredibly powerful. Whether you are a professional creator or this is your first time, it is certain that you will bring unique value to others.
|
||||
|
||||
- Memes
|
||||
- Images or gifs
|
||||
- Share in our :ref:`channels<contact>`
|
||||
|
||||
- Video
|
||||
- Device unboxing
|
||||
- How-to guides
|
||||
- Comparisons with other similar projects
|
||||
- Short or long-form reviews
|
||||
- Philosophical or technical concepts
|
||||
|
||||
- Audio
|
||||
- Podcasts, radio shows, or quick messages
|
||||
- Philosophical or technical concepts
|
||||
- Interviews / conversations (Please :ref:`Reach out<contact>` to us!)
|
||||
- Create audio from existing text content
|
||||
@@ -1,12 +0,0 @@
|
||||
|
||||
============
|
||||
Decentralize
|
||||
============
|
||||
|
||||
embassyOS allows users to swap to an alternative Marketplace in case they want a service not offered in the official `Start9 Marketplace <https://marketplace.start9.com>`_, would like a backup registry, or have for some reason lost trust in `Start9 <https://start9.com>`_.
|
||||
|
||||
- In order to change to an unofficial Marketplace, you can see our documentation :ref:`here <alt-marketplaces>`.
|
||||
|
||||
You can even run your own Marketplace using your Embassy! On each service's GitHub Releases page, such as `Bitcoin <https://github.com/Start9Labs/bitcoind-wrapper/releases/tag/v23.0.0>`_ for example, you will find the ``.s9pk`` Asset. You can download this package, upload to a folder on `File Browser <https://marketplace.start9.com/marketplace/filebrowser>`_ or `Nextcloud <https://marketplace.start9.com/marketplace/nextcloud>`_, and then host it over :ref:`Tor<tor>` using `Embassy Pages <https://marketplace.start9.com/marketplace/embassy-pages>`_!
|
||||
|
||||
A full specification to mimic our production Marketplace is forthcoming.
|
||||
@@ -1,73 +0,0 @@
|
||||
.. _contribute:
|
||||
|
||||
==========
|
||||
Contribute
|
||||
==========
|
||||
|
||||
Join the community and get involved!
|
||||
|
||||
.. raw:: html
|
||||
|
||||
<div class="topics-grid grid-container full">
|
||||
|
||||
<div class="grid-x grid-margin-x">
|
||||
|
||||
.. topic-box::
|
||||
:title: Create Content
|
||||
:link: content
|
||||
:icon: scylla-icon scylla-icon--tech-talks
|
||||
:class: large-4
|
||||
:anchor: Make
|
||||
|
||||
Share your knowledge with the community and amplify the signal.
|
||||
|
||||
.. topic-box::
|
||||
:title: Provide Support
|
||||
:link: provide-support
|
||||
:icon: scylla-icon scylla-icon--support
|
||||
:class: large-4
|
||||
:anchor: Assist
|
||||
|
||||
Help guide community members that are early in their sovereign journey.
|
||||
|
||||
.. topic-box::
|
||||
:title: Documentation
|
||||
:link: documentation
|
||||
:icon: scylla-icon scylla-icon--docs
|
||||
:class: large-4
|
||||
:anchor: Edit
|
||||
|
||||
Modify or add to our documentation.
|
||||
|
||||
.. topic-box::
|
||||
:title: Decentralize the Ecosystem
|
||||
:link: decentralize
|
||||
:icon: scylla-icon scylla-icon--cloud
|
||||
:class: large-4
|
||||
:anchor: Build
|
||||
|
||||
Help create the new Internet by bootstrapping necessary infrastructure.
|
||||
|
||||
.. topic-box::
|
||||
:title: Promote Start9
|
||||
:link: promote
|
||||
:icon: scylla-icon scylla-icon--summit
|
||||
:class: large-4
|
||||
:anchor: Shill
|
||||
|
||||
Become an affiliate and help propagate the message to your audience.
|
||||
|
||||
.. raw:: html
|
||||
|
||||
</div></div>
|
||||
|
||||
.. This is for the side navigation display
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
:hidden:
|
||||
|
||||
content
|
||||
provide-support
|
||||
documentation
|
||||
decentralize
|
||||
promote
|
||||
@@ -1,95 +0,0 @@
|
||||
:orphan:
|
||||
|
||||
.. _jobs:
|
||||
|
||||
===========
|
||||
Join Start9
|
||||
===========
|
||||
|
||||
How to Apply
|
||||
------------
|
||||
|
||||
Email us at jobs@start9.com with your resume and any other information you think we should know about you.
|
||||
|
||||
About Start9
|
||||
------------
|
||||
|
||||
Our mission at Start9 is to eliminate the need for trusted 3rd parties in the human/computer relationship. Our flagship product, embassyOS, is the most advanced, secure, and reliable personal server operating system in the world, making it possible for anyone to host their own software and data. One brick at a time, we will help construct an open and decentralized computing platform for humanity's future, one where sovereign individuals control their own data and the flow of information, as well as the abundance of intelligent devices that will come to engulf the human experience.
|
||||
|
||||
Read more about our `company and vision <https://start9.com/about>`_, or check out this `podcast <https://www.thesurvivalpodcast.com/digital-sovereign>`_.
|
||||
|
||||
Benefits of working at Start9
|
||||
-----------------------------
|
||||
|
||||
- Competitive salary
|
||||
|
||||
- Performance-based bonuses
|
||||
|
||||
- Equity. You're still early!
|
||||
|
||||
- Health and dental insurance
|
||||
|
||||
- Work from anywhere in the world, including our Denver office
|
||||
|
||||
- Budget for new computer
|
||||
|
||||
- Attend meetups and conferences
|
||||
|
||||
- Attend team retreats
|
||||
|
||||
General Considerations
|
||||
----------------------
|
||||
|
||||
At Start9, we seek passion and expertise. If you care deeply about freedom through technology and the mastery of your craft, you will fit in.
|
||||
|
||||
Open Positions
|
||||
--------------
|
||||
|
||||
Frontend Developer (JS)
|
||||
=======================
|
||||
|
||||
We are seeking a JS developer who is skilled with CSS and cares deeply about crafting beautiful user interfaces.
|
||||
|
||||
Start9 frontend devs leverage Angular, Typescript, and RXJS to deliver clean, modular, and performant codebases. The `embassyOS frontend codebase <https://github.com/Start9Labs/embassy-os/tree/master/frontend>`_ uses websockets and Start9's own nonce-based PatchDB to create a real-time sync and state management system with the backend. The user feels "plugged in" to their server, even if they are on the other side of the world.
|
||||
|
||||
Requirements:
|
||||
|
||||
- Significant experience working with modern Angular
|
||||
|
||||
- Familiarity with RXJS
|
||||
|
||||
- Strong CSS skills
|
||||
|
||||
- Writes clear and organized code
|
||||
|
||||
Backend Developer (Rust)
|
||||
========================
|
||||
|
||||
We are seeking a Rust developer to contribute to the `embassyOS backend codebase <https://github.com/Start9Labs/embassy-os/tree/master/backend>`_. The embassyOS backend is a novel and highly performant container management system that affords users granular control over applications running on their personal server.
|
||||
|
||||
Requirements:
|
||||
|
||||
- Familiarity with rust's async model and the tokio runtime
|
||||
|
||||
- Familiarity with Linux kernel intrinsics
|
||||
|
||||
- Computer science / computer engineering degree or equivalent experience
|
||||
|
||||
Bonus:
|
||||
|
||||
- Familiarity with the Linux FUSE apis
|
||||
|
||||
- sub-transport layer networking knowledge
|
||||
|
||||
Product Designer
|
||||
================
|
||||
|
||||
We are seeking a passionate product designer to lead UI/UX design at Start9, including our website, embassyOS, and ancillary products and marketing materials. Until now, Start9 devs have leaned heavily on stock html/css components with minimal styling. We are now determiend to step up our design game and need an expert to lead the charge.
|
||||
|
||||
Requirements
|
||||
|
||||
- Skilled with Figma and/or Sketch
|
||||
|
||||
- Obsessively pursues beauty and perfection
|
||||
|
||||
- High in empathy, understands user psychology
|
||||
@@ -1,11 +0,0 @@
|
||||
.. _promote:
|
||||
|
||||
=======
|
||||
Promote
|
||||
=======
|
||||
|
||||
If you have a large audience of any kind, you could qualify for Start9's affiliate program.
|
||||
|
||||
- Get a unique affilitate code to pass along to your audience.
|
||||
- A discount for your audience, and a kickback for you, if you choose.
|
||||
- Email us at affiliate@start9.com for more information.
|
||||
@@ -1,24 +0,0 @@
|
||||
.. _provide-support:
|
||||
|
||||
===============
|
||||
Provide Support
|
||||
===============
|
||||
|
||||
We aim to offer world-class support, but we need all the help we can get!
|
||||
|
||||
Community Channels
|
||||
------------------
|
||||
|
||||
1. If you see a query in one of our :ref:`Community Channels <contact>` that has not been answered, please respond!
|
||||
|
||||
- It is important for humans to be heard, so even letting someone know that the team may be offline can mean a lot. You can mention that the team is most active during North American daylight hours.
|
||||
- If you are confident you have the answer to a question, you may answer it yourself. We ask that you please be certain that you know the correct answer. You can always verify with a team member first or direct the inquirer to the relevant section of these docs (often the :ref:`FAQ<faq>`). This may also lead to suggestions about docs additions or edits.
|
||||
|
||||
2. Participate in our `Github Discussions <https://github.com/Start9Labs/embassy-os/discussions>`_ channel.
|
||||
|
||||
3. Make your voice heard in the unofficial feedback forum: https://s9.altweb.me/
|
||||
|
||||
4. If you would like to take on a more significant role in Support, please reach out to us at jobs@start9.com, or in one of our :ref:`Community Channels <contact>`.
|
||||
|
||||
- We are working on a volunteer program, which we eventually hope to incentivize.
|
||||
- It is also a foot in the door with Start9, where we are always growing and often in need of new team members.
|
||||
@@ -48,6 +48,15 @@ Developer Docs
|
||||
|
||||
Guides for implementing advanced service configurations
|
||||
|
||||
.. topic-box::
|
||||
:title: Documentation
|
||||
:link: documentation
|
||||
:icon: scylla-icon scylla-icon--docs
|
||||
:class: large-4
|
||||
:anchor: Edit
|
||||
|
||||
Contribute to our documentation.
|
||||
|
||||
.. raw:: html
|
||||
|
||||
</div></div>
|
||||
@@ -60,4 +69,5 @@ Developer Docs
|
||||
submission
|
||||
packaging
|
||||
specification/index
|
||||
advanced/index
|
||||
advanced/index
|
||||
documentation
|
||||
@@ -55,15 +55,6 @@
|
||||
|
||||
Read our FAQ, watch videos, and understand platform concepts
|
||||
|
||||
.. topic-box::
|
||||
:title: Contribute
|
||||
:link: contribute
|
||||
:icon: scylla-icon scylla-icon--networking
|
||||
:class: large-4
|
||||
:anchor: Join us
|
||||
|
||||
Use your skills to add to the Start9 ecosystem
|
||||
|
||||
.. topic-box::
|
||||
:title: Developer Docs
|
||||
:link: developer-docs
|
||||
@@ -86,5 +77,4 @@
|
||||
support/index
|
||||
diy/index
|
||||
learn/index
|
||||
contribute/index
|
||||
developer-docs/index
|
||||
|
||||
@@ -1,21 +0,0 @@
|
||||
.. _alt-marketplaces:
|
||||
|
||||
================
|
||||
Alt Marketplaces
|
||||
================
|
||||
|
||||
It is critical to Start9's mission that Start9 is **not** a central point of failure. The Marketplace is a critical piece of infrastructure and therefore embassyOS supports accessing alternative marketplaces.
|
||||
|
||||
.. caution:: Start9 is not responsible for issues encountered when downloading services from alternative marketplaces, and cannot provide support for services that are not from our official marketplace. Here be dragons!!
|
||||
|
||||
.. note:: Currently this change will only permit the downloading of *services* from alternative marketplaces. embassyOS itself may only be obtained from Start9.
|
||||
|
||||
#. Go to *Marketplace > Change*.
|
||||
|
||||
.. figure:: /_static/images/marketplaces/marketplace-switch0.png
|
||||
:width: 60%
|
||||
|
||||
#. Click "Add custom registry" and enter the URL of your desired Marketplace. You may connect immediately, or save for later use.
|
||||
|
||||
.. figure:: /_static/images/marketplaces/marketplace-switch1.png
|
||||
:width: 60%
|
||||
36
site/source/user-manual/alt-registries.rst
Normal file
36
site/source/user-manual/alt-registries.rst
Normal file
@@ -0,0 +1,36 @@
|
||||
.. _alt-registries:
|
||||
|
||||
======================
|
||||
Alternative Registries
|
||||
======================
|
||||
It is critical to Start9's mission that Start9 is **not** a central point of failure. Software distribution is critical infrastructure and therefore the Start9 Marketplace supports adding and accessing of custom registries for maximum resiliency and decentralization.
|
||||
|
||||
The most basic method Start9 has made available is the ability to use and distribute packages in their ``.s9pk`` form, which can be simply hosted as a file anywhere you'd like, even on your Start9 server (see below)! Start9 has also built open source tools for the Marketplace UI, to keep the community in maximum control with minimal inconvenience.
|
||||
|
||||
See this `blog post <https://blog.start9.com/start9-marketplace-strategy/>`_ for more details.
|
||||
|
||||
Changing Registries
|
||||
-------------------
|
||||
By default, there are 2 registries available in the Marketplace: Start9 (officially developed/supported) and Community (community developed/supported).
|
||||
|
||||
.. caution:: Start9 is not responsible for issues encountered when downloading services from alternative marketplaces, and cannot provide support for services that are not from our official marketplace. Here be dragons!!
|
||||
|
||||
Go to *Marketplace > Change*.
|
||||
|
||||
.. figure:: /_static/images/marketplaces/marketplace-switch0.png
|
||||
:width: 60%
|
||||
|
||||
Adding a Registry
|
||||
-----------------
|
||||
Click "Add custom registry" and enter the URL of your desired Marketplace. You may connect immediately, or save for later use.
|
||||
|
||||
.. figure:: /_static/images/marketplaces/marketplace-switch1.png
|
||||
:width: 60%
|
||||
|
||||
.. note:: Currently this change will only permit the downloading of *services* from alternative marketplaces. embassyOS itself may only be obtained from Start9 (or building from source) at this time.
|
||||
|
||||
Hosting a Registry
|
||||
------------------
|
||||
You can run your own basic registry using your Start9 server! On each service's GitHub Releases page, such as `Bitcoin <https://github.com/Start9Labs/bitcoind-wrapper/releases/tag/v23.0.0>`_ for example, you will find the ``.s9pk`` Asset. You can download this package, upload to a folder on `File Browser <https://marketplace.start9.com/marketplace/filebrowser>`_ or `Nextcloud <https://marketplace.start9.com/marketplace/nextcloud>`_, and then host it over :ref:`Tor<tor>` using `Start9 Pages <https://marketplace.start9.com/marketplace/embassy-pages>`_!
|
||||
|
||||
If you are interested in building and hosting your own full registry that can be accessed in the Start9 Marketplace UI, you can check out the `registry repository <github.com/start9labs/registry>`_.
|
||||
@@ -23,6 +23,6 @@ Welcome to the embassyOS user manual. Here you will discover all that your Embas
|
||||
sessions
|
||||
wifi
|
||||
ssh
|
||||
alt-marketplaces
|
||||
alt-registries
|
||||
device-guides/index
|
||||
upgrade-hardware/index
|
||||
Reference in New Issue
Block a user