Community posts: document storage and history for people; later improvements

Aberta Para iniciantes
  • Algo errado?
#508 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
76/100
Tipo de issue
Documentação
Clareza
Claramente especificada
Status de atividade
Ativa
Domínio
documentation

Direção de pesquisa

Leia docs/COLLABORATION_HANDOFF.md e os documentos voltados aos usuários docs/PEOPLE_CONVERSATIONS.md e docs/COLLABORATION_NETWORK_PROFILE.md. Substitua as explicações dispersas voltadas aos usuários por uma seção curta que aborde o comportamento descrito de armazenamento, visibilidade, histórico e arquivos de Library; mantenha os detalhes para desenvolvedores no documento de handoff e crie um link para a nova seção. O trabalho estará concluído quando as pessoas puderem encontrar uma única explicação clara e o documento de handoff apontar para ela.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

How Community posts are stored and passed on works, but it is documented only for developers and in pieces (docs/COLLABORATION_HANDOFF.md:79-80 has the 24 h / 200 posts / 1 MiB rule; docs/PEOPLE_CONVERSATIONS.md and docs/COLLABORATION_NETWORK_PROFILE.md cover the protocol). No doc tells a person what happens to a post.

Facts (source at 8a74b669c):

  • Each Home keeps the posts Chat shows (newest 500 per conversation, no age limit) and the signed originals it passes on (24 h, at most 200 posts and 1 MiB). Both are plain JSON in the Home's data folder.
  • No server stores posts. The seed's Community node relays gossip and keeps nothing on disk.
  • A Home that was offline gets missed posts only from Homes online now, only if both sides show presence, and only from the last 24 h.
  • Posts are signed but not encrypted: every member, and every node on the topic including the seed hub, can read them.
  • A post cannot be deleted or edited; other Homes keep it until it falls out of their newest 500.
  • A Library file posted in Community stays on the sender's Home; only the sender's contacts can fetch it while that Home runs.

1. Document it (replace, not add): one short section in the user docs, built from the facts above, that replaces the scattered user-facing bits; the developer detail stays in COLLABORATION_HANDOFF.md and links to it.

2. Improvements to decide later:

  • Delete your own post (a signed retraction that other Homes honor).
  • Longer history: catch-up beyond 24 h and 200 posts, and catch-up that does not require showing presence.
  • Encrypt stored posts at rest, like the per-person direct-message store.
  • Private Communities: membership instead of the open grant, and posts encrypted to members.
  • Say in Chat, once and briefly, that Community posts are public.
Linguagem predominante
Rust
Estrelas
6
Forks
2
Merge médio
1d 3h
PRs com merge (30d)
42

Preparar o ambiente

Este projeto não oferece contêiner de desenvolvimento, Dockerfile nem guia de contribuição, então a configuração fica por sua conta: comece pelo README e veja nosso guia da primeira contribuição para os passos gerais.

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de elastos/elastos-runtime

Todas as issues de elastos/elastos-runtime

Issues semelhantes

Mais issues de Rust

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.