New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Rewrite introduction to include a brief description of Informo #19

Open
wants to merge 6 commits into
base: master
from

Conversation

Projects
None yet
2 participants
@vabd
Copy link
Member

vabd commented Jan 10, 2019

After talking about Informo with a few people, I realised most of them didn't really know what it's about, or how it was supposed to work, despite there being an entire page dedicated to that matter.

One thing that would help in a major way would be to have a short description about Informo in the introduction page, so newcomers can get a broad idea of what it is with starting points if they're interested in diving deeper into it, instead of having to look for that information through the specs website.

Although it doesn't technically introduce a change in behaviour, I'm tagging the SCS as such so people can have some time to give it a look and share their feedback, in order to hopefully end up with the most newcomer-friendly intro possible.

I've also used this as an opportunity to rewrite part of a paragraph in the "What is Informo?" page to bring it up to date with the general tone of the specs.

@vabd vabd requested a review from Informo/informo-core-team Jan 10, 2019


This significantly hampers censorship because:

* every server knows about the information, the whole federation must be

This comment has been minimized.

@GordonF42

GordonF42 Jan 19, 2019

Member
Suggested change Beta
* every server knows about the information, the whole federation must be
* Every server knows about the information, so the whole federation must be

This comment has been minimized.

@vabd

vabd Jan 19, 2019

Member

First word in a bullet point item shouldn't be captialised.

* every server knows about the information, the whole federation must be
blocked in order to censor it. The list of servers participating in a
federation can continuously grow and change, which can render such a blockade
practically very hard, if not impossible, to manage.

This comment has been minimized.

@GordonF42

GordonF42 Jan 19, 2019

Member
Suggested change Beta
practically very hard, if not impossible, to manage.
practically very hard, if not impossible to manage.

This comment has been minimized.

@vabd

vabd Jan 19, 2019

Member

Err, the comma should stay here.

federation can continuously grow and change, which can render such a blockade
practically very hard, if not impossible, to manage.

* the Matrix protocol is built upon

This comment has been minimized.

@GordonF42

GordonF42 Jan 19, 2019

Member
Suggested change Beta
* the Matrix protocol is built upon
* The Matrix protocol is built upon

This comment has been minimized.

@vabd

vabd Jan 19, 2019

Member

Same as above.

practically very hard, if not impossible, to manage.

* the Matrix protocol is built upon
[HTTP](https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol), which is

This comment has been minimized.

@GordonF42

GordonF42 Jan 19, 2019

Member
Suggested change Beta
[HTTP](https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol), which is
[HTTPS](https://en.wikipedia.org/wiki/Hypertext_Transfer_Protocol), which is

maybe? or not since you speak of TLS later in the paragraph

This comment has been minimized.

@vabd

vabd Jan 19, 2019

Member

HTTP and TLS are described for the benefit both of them bring to the table on their own. The benefit mentioned from this line is related to HTTP, not HTTPS.

Show resolved Hide resolved content/introduction/_index.md Outdated
are described in [their own section](/information-distribution).

On top of that, Informo also provides trust management mechanisms which are
designed to let readers have a reliable idea of who an information source really

This comment has been minimized.

@GordonF42

GordonF42 Jan 19, 2019

Member

I'd rather say designed to let readers build a reliable source of information without having ...

let me know what you think

This comment has been minimized.

@vabd

vabd Jan 19, 2019

Member

Err, users don't build a source of information, and I didn't really want to start mentioning trust networks from there. I think the current version fit the need of having a short description of trust management in one sentence without bringing up too many specific concepts.

@GordonF42

This comment has been minimized.

Copy link
Member

GordonF42 commented Jan 19, 2019

mostly typos

GordonF42 and others added some commits Jan 19, 2019

Update content/introduction/_index.md
Co-Authored-By: vabd <34184120+vabd@users.noreply.github.com>

@vabd vabd requested a review from Informo/informo-core-team Jan 19, 2019

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment