Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
208 lines (187 sloc) 12.8 KB
<!DOCTYPE html>
<html>
<head>
<title>Systems</title>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width">
<link rel="stylesheet" type="text/css" href="./main.css">
</head>
<body>
<ls-header center>
<h1>Systems</h1>
<p>
Subjective guides for using simple systems,<br/>
organize digital content and cooperate on projects.
</p>
</ls-header>
<section>
<details>
<summary>
Introduction
</summary>
<p>These guides should have for objective to help you get going with your projects. They are trying to favor <a href="https://en.wikipedia.org/wiki/Free_software">free software</a> solutions to protect your freedom and privacy, as well as the one of people you cooperate with. When these solutions are too technicaly complex to setup and use, alternatives are suggested.</p>
<p>You can use these guides for projects of any types, in subject you see them fit. They are targeted to an audience willing to learn how to use tools and concepts worth their time.</p>
<p>Research these tools, services, solutions and systems, use them at your own risks from conscious and informed choices.</p>
<p>In a perfect universe, the systems described in these guides should be simple to use and setup; favor secure solutions, respect the rights and data of their empowered users.</p>
</details>
<details>
<summary>
Help?
</summary>
<p>Do you need assistance or would like to improve this document and the systems?</p>
<p>Each projects have their own discussion channels to keep the feedbacks and its content organized. As a quick rule of thumb, you should ask your question as close as possible to where the problem is located. Don't worry if you're not sure, come chat to get support!</p>
<ul>
<li>Come <a href="http://cat.internet4000.com">chat with the community</a>.</li>
<li>Join the discussion to <a href="https://github.com/internet4000/systems/issues">improve this document</a>.</li>
</ul>
</details>
</section>
<section>
<ls-header>
<h2>Communication</h2>
<p>Access to informations and communications through secure channels.</p>
</ls-header>
<details>
<summary>
Web browsing + VPN
</summary>
<p>For browsing the web, accessing any website, you should use a free web browser. It is a major part of keeping your data and communications secure.</p>
<p>Download and install Mozilla's <a href="https://www.mozilla.org/en-US/firefox">Firefox</a>. You can (and should) also use it on your mobile devices, look in your application store of your platform.</p>
<p>Install <a href="https://addons.mozilla.org/en-US/firefox/addon/ublock-origin/">ublock-origin</a> for Firefox to block most advertising.</p>
<p><a href="https://www.opera.com">Opera</a>, comes integrated with a <a href="https://en.wikipedia.org/wiki/Virtual_private_network">VPN</a> (with multiple location in the world).</p>
<p>For more secure browsing needs <a href="https://www.torproject.org/">Tor</a> is an option.</p>
<p>If you would like that all trafic of your devices goes through a VPN, try <a href="https://protonvpn.com">ProtonVPN</a> (same company as ProtonMail).</p>
</details>
<details>
<summary>
Chat
</summary>
<p>Chat is great for conversations between friends, familly and cooperators to your projects. Use <a href="https://riot.im">Riot</a>. Here are some of its benefits:</p>
<ul>
<li>Riot uses <a href="https://matrix.org">matrix</a>, the open network for secure, decentralized communication.</li>
<li>You can have two persons and group conversations, public and private communities (replaces all whatsapp, facebook messenger, slack...), video, audio, files etc.</li>
<li>A matrix user adress looks like a weird email, <i>@you:matrix.org</i>. It works without the need of a phone number, on the web (in your web-browser) and any other of your devices.</li>
<li>You could host your own server and still communicate with all other matrix users. This because your server would be part of matrix's decentralized network, <i>@you:yoursite.org</i>.</li>
</ul>
<p>
If you want to join your first group chat, you're welcome on this community channel: <a href="http://chat.internet4000.com/">#i4k-doctor:matrix.org</a> (a group adress starts with a <i>#</i>, not a <i>@</i> used for users).
</p>
</details>
<details>
<summary>
Email
</summary>
<p>An email address is usefull to communicate, and often required to create an account somewhere online (also in some of these guides).</p>
<p>We recommand you to use <a href="https://protonmail.com/">ProtonMail</a>, as it is the easiest way to have a secure email account, receive and send encrypted emails. It can also be used for organization email, and replace company Google Emails plans.</p>
<p>Read the <a href="https://emailselfdefense.fsf.org/en/">Email self defense guide</a>, for a general overview of email security. As an alternative to Protonmail, you could use <a href="https://riseup.net/">Riseup</a>.</p>
</details>
<details>
<summary>
Mobile communication
</summary>
<p><a href="https://signal.org">Signal</a> is a secure mobile communication application. Riot/matrix described in the chat section is a prefered alternative because it is decentralized and free software.</p>
</details>
</section>
<section>
<ls-header>
<h2>Project-management</h2>
<p>How to create projects, organize them and allow cooperation.</p>
</ls-header>
<details>
<summary>
Create a <strong>git</strong> provider account
</summary>
<p>The <a href="https://en.wikipedia.org/wiki/Git" title="Wikipedia article for Git">Git</a> protocol allows people to cooperate together on projects. It keeps track of folders and files, their history of changes.</p>
<p>A Git provider, allows you to store these projects online, manage users, the collaboration on each projects. You can use this as a project management tool for your organization and projects.</p>
<p>The Git Provider is the place which will store the content and the code for your projects.</p>
<p>If you don't have an account already, create a free user account at one of these providers: <a href="https://gitlab.com">Gitlab</a>, <a href="https://github.com">Github</a>.</p>
<p><strong><a href="https://gitlab.com/users/sign_in">Gitlab</a></strong> is a safer choice because it is <a href="https://www.gnu.org/philosophy/free-software-for-freedom.en.html">open source</a> software; this make it easily possible to host your own Gitlab server, and have fullcontroll over its data (on servers you own).</p>
<p><i>Note:</i> the git protocol is not made for large file sharing (no upper limit, but 50 mega is already considered large).</p>
</details>
<details>
<summary>
Create your cooperation group
</summary>
<p>If you want to have multiple people working together on projects, you can create a group to connect them.</p>
<p>Create a <a href="https://gitlab.com/">Gitlab group</a>, or a <a href="https://github.com">Github organization</a>; depending on your preference, and where you already have created a user account.</p>
<p>There is also maybe already existing groups and organizations that you can join.</p>
</details>
<details>
<summary>
Organize a cooperation
</summary>
<p>Working alone or together always require some organisation. To cooperate using Git, and a Git provider, you need to have in mind a few concepts.</p>
<ul>
<li>In the Git world, <strong>a project is called a repository</strong>. It is just a normal folder, in which you can put files and other folders. The difference is that it keeps an history of all changes, and manage them to favor organized cooperation.</li>
<li>Each project can have <strong>issues</strong> attached. An issue, is a topic someone would like to discuss to improve the project.</li>
<li>It is <strong>possible to manage who can access and cooperate on each project</strong> (repository) individually, or globaly at your group/organization level.</li>
</ul>
<p>A nice workflow would be for you and your teams to create a new repository for each project you would like to cooperate on. In this repository, you can have all the content (files and folders), close to the issues your teams are trying to solve.</p>
</details>
<details>
<summary>
File sharing
</summary>
<p>For temporary sending and sharing files to other people, you can use <a href="https://send.firefox.com">Firefox Send</a>.</p>
<p><a href="https://nextcloud.com/">Nextcloud</a> seems to be the only alternative to Google Drive and Dropbox, for file sharing capabilities, user management, contact and calendars synchronisation. Still a technical solution, it is maybe not yet an alternative for most users. <a href="https://mega.nz/">Mega</a> can also be used for sharing and synchronising files with teams, and has a large free plan.</p>
</details>
</section>
<section>
<ls-header>
<h2>Websites and widgets</h2>
<p>For each projects bellow, learn more by following their links. In most cases you will need to have a git + hosting provider accounts setup (see the guides).</p>
</ls-header>
<details>
<summary>
Domain names (.org, .com, etc.)
</summary>
<p>A <a href="https://en.wikipedia.org/wiki/Domain_name">domain name</a> can be used to have a URL people can remember and share.</p>
<p>Website hosting providers often provide you with a URL that you can share for your sites. It is also possible to have custom domain names (and <a href="https://en.wikipedia.org/wiki/Subdomain">subdomains</a>).</p>
<p>You can use <a href="https://iwantmyname.com/">iwantmyname</a>, <a href="https://domains.google.com/">Google Domains</a> or any other <a href="https://en.wikipedia.org/wiki/Domain_name_registrar">registrar</a> at your convenience. They will allow you to rent a domain name (if available), with a yearly fee (price depend on the domain extension, .com .org etc)</p>
</details>
<details>
<summary>
Create a website hosting provider account
</summary>
<p>The website hosting is the service that takes your repositories, deploy them as websites and make them accessible online to the world.</p>
<p>Netlify is a provider that takes your Git projects, and deploy them as websites, with a URL address that you can share to anyone. We will use it often in these guides because it also offers a practical free hosting.</p>
<p><a href="https://app.netlify.com/signup">Create a Netlify account</a>, you can register with your email, a Gitlab or Github account (as you prefer; you will need to connect your git provider later, to deploy your git projects as sites).</p>
<p>If you're looking for a more general hosting provider (not covered in the guides), you can look at <a href="https://www.scaleway.com/">Scaleway</a> or <a href="https://www.digitalocean.com/">DigitalOcean</a>.</p>
</details>
</section>
<section>
<!-- <details>
<summary>
Deploy a dashboard website for your group/organisation
</summary>
<p>This guide is currently for Github organisations only (will change asap).</p>
<p>The dashboard helps the members of your organization to see what are your projects, and where help is needed.</p>
<p>See an example usage with the <a href="https://d.internet4000.com/">Internet4000 dashboard</a>.</p>
<p>Explore the <a href="https://github.com/internet4000/dashboard-organisation">code and documentation</a></p>
<p><a href="https://app.netlify.com/start/deploy?repository=https://github.com/internet4000/dashboard-organisation">Deploy an organisation dashboard</a> for your Github organization or user; see documentation above for documentation.</p>
</details> -->
<details>
<summary>
Deploy a portfolio website
</summary>
<p>This guide is currently for Github organisations only (will change asap).</p>
<p>The portfolio is a website to present projects and their content.</p>
<p>Here is <a href="https://portfolio.internet4000.com/">an example portfolio</a>, where the content is the documentation on how to use and create a new portfolio.</p>
<p>You can directly <a href="https://app.netlify.com/start/deploy?repository=https://github.com/internet4000/portfolio-hugo-starter">deploy a new portfolio</a>.</p>
</details>
<details>
<summary>
Integrate your Instagram content to your website
</summary>
<p>In case you are using Instagram and would like to re-use this content somewhere else on the internet.</p>
<p><a href="https://instagram.internet4000.com">Create an Instagram widget</a>, to be able to embed it on your different sites.</p>
</details>
</section>
<ls-header center>
<p>More guides should come uppon needs and requests.</p>
<nav>
<a href="https://github.com/internet4000/systems/blob/master/index.html">Edit this page</a>, <a href="https://github.com/internet4000/systems/issues">feedback</a>.
</nav>
</ls-header>
</body>
</html>
You can’t perform that action at this time.