From a94ee14e742579cae2ff270ffc6e3da401194d62 Mon Sep 17 00:00:00 2001 From: Flancian <0@flancia.org> Date: Wed, 11 Aug 2021 16:56:05 +0200 Subject: [PATCH] Default commit message, part of an automated flow. --- agora editor.md | 4 ++++ agora howto.md | 20 ++++---------------- agora install.md | 15 ++------------- agora signup.md | 17 +++++++++++++++++ journal/2021-08-11.md | 2 ++ supported formats.md | 8 ++++++++ 6 files changed, 37 insertions(+), 29 deletions(-) create mode 100644 agora signup.md create mode 100644 supported formats.md diff --git a/agora editor.md b/agora editor.md index fdc0e5252..78f4688b2 100644 --- a/agora editor.md +++ b/agora editor.md @@ -1,5 +1,9 @@ # Agora Editor +- To contribute to the [[Agora]], you need to write down notes or posts in one of the [[supported formats]] and upload your notes to a ***git repository*** of your choice. These steps are expanded below. + - Get a [[github]] account if you don't have a git host already: . + - Install [[git]] if needed: . It should be installed by default in [[linux]], comes bundled with [[mac os]]. + - See [[agora signup]] for more details on the process. - In a nutshell: you need to host your notes (more generally, [[resources]], defaulting to [[markdown]] plus [[wikilinks]]), somewhere online. And then let the [[agora]] know about it. - The Agora doesn't host your data, but rather pulls it from a location *you* control and renders it for you and other users; in the process interlinking your data with that of other users. - Most users currently host [[git]] repositories on https://github.com or https://gitlab.com. diff --git a/agora howto.md b/agora howto.md index 0353785bb..5e7d6bbec 100644 --- a/agora howto.md +++ b/agora howto.md @@ -1,18 +1,6 @@ # Agora Howto -- To [[read]] the Agora, you don't need anything but a [[web browser]]. - - This [[Agora]] is fully browsable on . - - You can add the Agora as a [[search engine]]. -- To [[contribute]] to the Agora, first you need to publish your [[digital garden]] or [[content]] elsewhere online. The Agora doesn't host your data, but rather pulls it from a location *you* control and renders it for you and other users; it interlinks it with that of other users. - - If you know your way around [[git]], [[markdown]] on git is the default format. If you use [[roam]] or a [[roam like]] or you have a notes database, you're almost there. - - Whatever participation mechanism you choose, you need to let an Agora [[maintainer]] know where your content is, so it can be pulled and [[integrated]]. We strive to continuously support new sources and formats. Please send email to signup@anagora.org with: - - The URL for your content. - - Your desired username. - - The Agora wants to be [[maximally inclusive]], but it is in its infancy; it is a [[work in progress]]. If you want to participate and can't, please also send email to signup@anagora.org to let us know. - - Through projects such as [[agora twitter integration]], we hope to make the Agora available to anyone that has access to a social network account. -- Please refer to [[agora install]] for detailed setup instructions and [[agora editor]] for alternative clients. - - [[pull]] [[agora editor]] [[agora install]] -- [[go]] https://github.com/flancian/agora/blob/master/docs/howto.md - - - +- To join an Agora: + - [[pull]] [[agora signup]] +- To run an Agora: + - [[pull]] [[agora install]] diff --git a/agora install.md b/agora install.md index 19d7bad00..8f1fcd6f7 100644 --- a/agora install.md +++ b/agora install.md @@ -1,15 +1,4 @@ # Agora Install -- To contribute to the [[Agora]], you need to write down notes or posts in [[Markdown format]] and upload your notes to a ***git repository*** of your choice. These steps are expanded below. - - Get a [[github]] account if you don't have a git host already: . - - Install [[git]] if needed: . It should be installed by default in [[linux]], comes bundled with [[mac os]]. - - If you don't have a [[personal knowledge management]] system of choice to manage your notes, we currently recommend [[obsidian]]. [[foam]] also works well. - - See [[agora editor]] for alternatives. -- Then send email to signup@anagora.org or a Twitter DM to [[flancian]] with: - - The URL of your repo. - - Your desired username (can be distinct from that of your git host). - - Confirmation that you agree to the Agora's [[contract]] (only the one by the @agora user; other contracts are optional). -- Non-git sources and formats other than [[Markdown]] will be supported in the future; if you store your notes using some other system, please reach out. -- See also (needs updating): [agora howto](https://anagora.org/go/agora-howto). - - +- a [[howto]]. +- These are instructions to [[run your own agora]]. If you are looking for instructions on how to *join* this agora, please refer to: [[agora editor]], [[agora signup]]. diff --git a/agora signup.md b/agora signup.md new file mode 100644 index 000000000..59566af16 --- /dev/null +++ b/agora signup.md @@ -0,0 +1,17 @@ +# agora signup + +- To [[read]] the Agora, you don't need anything but a [[web browser]]. + - This [[Agora]] is fully browsable on . + - You can add the Agora as a [[search engine]]. +- To [[contribute]] to the Agora, first you need to publish your [[digital garden]] or [[content]] elsewhere online. The Agora doesn't host your data, but rather pulls it from a location *you* control and renders it for you and other users; it interlinks it with that of other users. + - If you know your way around [[git]], [[markdown]] on git is the default format. If you use [[roam]] or a [[roam like]] or you have a notes database, you're almost there. + - Whatever participation mechanism you choose, you need to let an Agora [[maintainer]] know where your content is, so it can be pulled and [[integrated]]. We strive to continuously support new sources and formats. + - You can send email to signup@anagora.org or reach out to a member of [[flancia collective]] with: + - The URL of your repo or content. + - Your desired username. + - Confirmation that you agree to the Agora's [[contract]] (only the one by the @agora user; other contracts are optional). + - Alternatively if you know your way around [[git]] you can send a PR for `gardens.yaml` in the Agora repo: [[go/agora]]. + - The Agora wants to be [[maximally inclusive]], but it is in its infancy; it is a [[work in progress]]. If you want to participate and can't, please also send email to signup@anagora.org to let us know. + - Non-git sources and formats other than [[Markdown]] will be supported in the future; if you store your notes using some other system, please reach out. + - Through projects such as [[agora twitter integration]], we hope to make the Agora available to anyone that has access to a social network account. +- Please refer to [[agora install]] in case you want to run your own Agora; and to [[agora editor]] for more information on clients. diff --git a/journal/2021-08-11.md b/journal/2021-08-11.md index 0eb565d43..54888395b 100644 --- a/journal/2021-08-11.md +++ b/journal/2021-08-11.md @@ -14,3 +14,5 @@ - [[flow]] - fixed backup issue that was plaging thecla/filling up space - finally added agora-server and agora-bridge as systemd (user) services succesfully + - [[agora howto]] + - [[agora signup]] diff --git a/supported formats.md b/supported formats.md new file mode 100644 index 000000000..68d12bea0 --- /dev/null +++ b/supported formats.md @@ -0,0 +1,8 @@ +# Supported formats + +- a [[list]]. + - The [[Agora]] supports: + - [[plain text]] + - [[markdown]] (plus [[wikilinks]]) + - [[org mode]] (in progress) +