briar issueshttps://code.briarproject.org/groups/briar/-/issues2023-08-28T16:00:10Zhttps://code.briarproject.org/briar/briar-mailbox/-/issues/194Documentation forthcoming?2023-08-28T16:00:10Zcoreless corelessDocumentation forthcoming?Will there be documentation added to the wiki about administering Briar Mailbox?
Perhaps I am mistaken, but the version number (1.0.5) implies Briar Mailbox is considered stable and fit for production use? If so, I'd like to deploy it ...Will there be documentation added to the wiki about administering Briar Mailbox?
Perhaps I am mistaken, but the version number (1.0.5) implies Briar Mailbox is considered stable and fit for production use? If so, I'd like to deploy it for my own use as well as my community, but I would benefit from documentation about how to do so.https://code.briarproject.org/briar/briar-desktop/-/issues/249Update information in README regarding previews2022-09-04T20:39:39ZMikolai GütschowUpdate information in README regarding previewsCurrently it reads:
> Briar Desktop makes use of [Compose for Desktop](https://www.jetbrains.com/lp/compose/) to build its UI. The Intellij IDEA plugin [Compose Multiplatform IDE Support](https://plugins.jetbrains.com/plugin/16541-compo...Currently it reads:
> Briar Desktop makes use of [Compose for Desktop](https://www.jetbrains.com/lp/compose/) to build its UI. The Intellij IDEA plugin [Compose Multiplatform IDE Support](https://plugins.jetbrains.com/plugin/16541-compose-multiplatform-ide-support) provides static previews of composable functions without parameters which are annotated with `@Preview`.
We don't actually use those static previews, but our own, interactive ones.https://code.briarproject.org/briar/briar-manual/-/issues/6Table of contents is incomplete2020-12-21T12:10:31ZakwizgranTable of contents is incompleteSome sections of the manual are missing from the table of contents sidebar.Some sections of the manual are missing from the table of contents sidebar.CleopatraCleopatrahttps://code.briarproject.org/briar/website/-/issues/29Expand FAQs2022-11-18T17:32:17ZCleopatraExpand FAQsSubtask of #28
```
- What is Briar?
- How does Briar work?
- Why is it called Briar?
- How is Briar different from other messaging apps?
- How do I install/update/uninstall Briar?
- What platforms can I use Briar on?
- Can I send files ...Subtask of #28
```
- What is Briar?
- How does Briar work?
- Why is it called Briar?
- How is Briar different from other messaging apps?
- How do I install/update/uninstall Briar?
- What platforms can I use Briar on?
- Can I send files and images?
- Can I do video calls?
- Why is Briar is always logged out every time I open the app?
- What is the difference between a forum, private group and blog?
- What does Briar use for end2end encryption
- How are messages delivered?
- Why is my connection to a private group so slow?
- What happens to abandoned accounts?
- Why does Briar drain more battery?
- What are some limitations of Briar?
- how can briar sync over the internet without a server? how do you know where to send the sync to? don't you need some kind of known address or middleman to sync?
```CleopatraCleopatrahttps://code.briarproject.org/briar/briar-manual/-/issues/5Prepare manual for translation2020-12-01T14:00:23ZCleopatraPrepare manual for translationCleopatraCleopatrahttps://code.briarproject.org/briar/briar-manual/-/issues/4Improve manual2021-01-31T04:27:47ZCleopatraImprove manualWe need more content and rich media. The document structure can be improved too.
#### Proposed structure
```
- Migrate to https://docs.briarproject.org/ ??
- Content:
About Briar:
What is Briar
How Briar w...We need more content and rich media. The document structure can be improved too.
#### Proposed structure
```
- Migrate to https://docs.briarproject.org/ ??
- Content:
About Briar:
What is Briar
How Briar works
Installation:
Google Play
F-droid
Apk
Running Briar for the first time:
Creating an account
Contacts:
Add Contacts:
Add contact at a distance
Add contact nearby
Deleting contacts
Introducing contacts
Messaging:
Private Groups:
Create a group
Invite contacts
Forums
Blogs:
Write a blog post
Reblog
RSS Feeds
Settings:
Language & Region
Theme
Connections:
Via the internet
Via Wi-Fi
Via Bluetooth
Connection method for Tor network
Use mobile data
Connect to the internet only when charging
Security:
App lock
Change password
Panic button
Notifications
Feedback
Updating:
Google Play
F-droid
Apk
Uninstalling
Known issues/limitations
```CleopatraCleopatrahttps://code.briarproject.org/briar/website/-/issues/28Add "Support" page2022-11-18T17:32:17ZCleopatraAdd "Support" pageLet's consider having a "Support" page
#### Proposed structure
- Links:
User manual
Known issues/limitations
Open issues on Gitlab
- FAQs:
Migrate from https://code.briarproject.org/briar/briar/-...Let's consider having a "Support" page
#### Proposed structure
- Links:
User manual
Known issues/limitations
Open issues on Gitlab
- FAQs:
Migrate from https://code.briarproject.org/briar/briar/-/wikis/FAQ
Expand FAQs
- Get in Touch:
https://chat.briarproject.org/
IRC
Email
- Glossary
- Report a bug
- Request a feature / Give feedbackCleopatraCleopatrahttps://code.briarproject.org/briar/website/-/issues/27Improve footer2020-12-01T13:33:10ZCleopatraImprove footerCan we add links to the following pages to the footer?
* Newsletter subscribe form
* News:
- Social media links
- Blog
- Press
* Get involved:
- Donate
- Contribute
- Jobs
...Can we add links to the following pages to the footer?
* Newsletter subscribe form
* News:
- Social media links
- Blog
- Press
* Get involved:
- Donate
- Contribute
- Jobs
* Legal:
- Copyright
- Privacy
- Code of Conduct
- License
* Support:
- FAQs
- Documentation
- ContactCleopatraCleopatrahttps://code.briarproject.org/briar/website/-/issues/26Revamp landing page2021-04-13T08:55:55ZCleopatraRevamp landing pageThe [landing page](https://briarproject.org) could use more content. This will help improve search engine rankings in the long run. Other modifications will be made, as identified in https://code.briarproject.org/briar/website/-/issues/6...The [landing page](https://briarproject.org) could use more content. This will help improve search engine rankings in the long run. Other modifications will be made, as identified in https://code.briarproject.org/briar/website/-/issues/6#note_43093
### Proposed structure:
First section:
- "Secure messaging, anywhere" tagline
- "Peer-to-peer encrypted messaging and forums" tagline
- Download link
- Contribute link
Second section:
- Explain Briar features
Encrypted messaging
Secure storage
Offline connection
Free and open source
- Links:
How Briar works
Download Briar
Third section:
- News link
Fourth section:
- Who uses Briar?:
Activists
Journalists
You
Fifth section:
Get Briar:
Fdroid
Google Play
Direct .apk downloadCleopatraCleopatrahttps://code.briarproject.org/briar/website/-/issues/25Write guides on how to contribute2021-04-12T11:16:53ZCleopatraWrite guides on how to contributeCurrently, the [Get Involved](https://briarproject.org/get-involved/) page is not very detailed. It'll be nice to have detailed guides on how to contribute to Briar, depending on skills and interests.
### Proposed structure
Make a ...Currently, the [Get Involved](https://briarproject.org/get-involved/) page is not very detailed. It'll be nice to have detailed guides on how to contribute to Briar, depending on skills and interests.
### Proposed structure
Make a donation
Share your experience:
- Report bugs
- Test Briar
- Provide feedback
- Help other Briar users
Contribute your language skills:
- Improve documentation
- Write news and blog posts
- Translate
Promote Briar:
- Write press releases
- Design outreach material
- Talk about Briar at events
Contribute your computer skills:
- Work on the source code
- Improve Briar's infrastructure
- Improve the website
- Design graphics
- Improve UX
Reference documents:
- Code of conduct
- Merge policy
- Release process & schedule
- Glossary
- Logo
- Developer docs
Contributor tools:
- Source code: Git repositories
- Roadmap
- Building the app from source
- Starter tasks for new contributors
- Git workflow
- Join the mailing listCleopatraCleopatrahttps://code.briarproject.org/briar/website/-/issues/21Improve menu structure2022-11-18T17:32:16ZCleopatraImprove menu structure@akwizgran @grote
Referencing [a chat](https://chat.briarproject.org/briar/pl/yciiahqe8pyajqc57re917rz1y) on the UX channel:
> i think submenus would be fine (assuming we do them in css). we might want to do some user testing to make s...@akwizgran @grote
Referencing [a chat](https://chat.briarproject.org/briar/pl/yciiahqe8pyajqc57re917rz1y) on the UX channel:
> i think submenus would be fine (assuming we do them in css). we might want to do some user testing to make sure people with different amounts of technical skill can find what they're looking for
>
> about, documentation and download are pretty common top-level menu items for software projects, although i agree download may not be necessary for us as it's on the front page
>
> so perhaps:
>
> about
> news
> team
> contact
> documentation
> how it works
> user manual
> faq
> wiki
> community
> get involved
> source code
> style guide
------------------
I don't see the point of having submenus. We can show only the most important stuff by keeping the menu structure as simple as:
- About
- Download
- Documentation
- Support
- News
- Contribute
- DonateCleopatraCleopatrahttps://code.briarproject.org/briar/briar-manual/-/issues/3Update manual to explain globe icon colours2020-11-15T16:15:46ZCleopatraUpdate manual to explain globe icon coloursAs mentioned [here](https://code.briarproject.org/briar/briar/-/issues/1763#note_41736):
> Sorry, we haven't updated the manual yet to explain the icon colours. Orange means Briar is connecting to the Tor network - messages can't be sent...As mentioned [here](https://code.briarproject.org/briar/briar/-/issues/1763#note_41736):
> Sorry, we haven't updated the manual yet to explain the icon colours. Orange means Briar is connecting to the Tor network - messages can't be sent or received via the Internet in this state. Green means Briar's connected to the Tor network and it should be possible to send or receive messages (although it may take a minute or two before your contacts notice that you're connected and try to send any messages that were waiting to send).CleopatraCleopatrahttps://code.briarproject.org/briar/briar/-/issues/1751Explain visibility of reblogs/comments2020-11-15T15:29:27ZakwizgranExplain visibility of reblogs/commentsA user was surprised to learn that a reblogged post was visible to all contacts of the user who reblogged the post, rather than all contacts of user who wrote the original post. We should add some onboarding to explain this the first tim...A user was surprised to learn that a reblogged post was visible to all contacts of the user who reblogged the post, rather than all contacts of user who wrote the original post. We should add some onboarding to explain this the first time the reblog/comment feature is used.https://code.briarproject.org/briar/briar/-/issues/1690Add private message deletion to user manual2020-11-15T17:10:49ZakwizgranAdd private message deletion to user manualCleopatraCleopatrahttps://code.briarproject.org/briar/briar/-/issues/1578Improve structure of Briar Headless API documentation2021-03-22T10:52:52ZNicoImprove structure of Briar Headless API documentationCurrently, the documentation for the API is directly written into [its readme file](https://code.briarproject.org/briar/briar/blob/release-1.1.7/briar-headless/README.md). That's fine for the beginning, [I was even able to build a first ...Currently, the documentation for the API is directly written into [its readme file](https://code.briarproject.org/briar/briar/blob/release-1.1.7/briar-headless/README.md). That's fine for the beginning, [I was even able to build a first prototype with it](https://nico.dorfbrunnen.eu/posts/2019/briar-first-demo/).
However, I suggest to improve the structure of the documentation by moving it into a separate repository. My suggestion was to create a Hugo page with a docs theme (or some other static site generator) at docs.briarproject.org.
@grote's response to this was (loosely translated by me): "Best to make the documentation directly into the code with swagger"
My response to this now: OK, we can do this, but I don't know how much sense it makes to put a lot of basic explanations into code. E.g. all the valuable information collected in https://code.briarproject.org/briar/briar/issues/1577.
**Update:** I agree with Torsten that it's best to generate the documentation from code. That's what I do with [`briar_wrapper`](https://code.briarproject.org/briar/python-briar-wrapper), too, at https://wrapper.docs.briarproject.org/ and the API's docs can be hosted at https://api.docs.briarproject.org/, imho.CleopatraCleopatrahttps://code.briarproject.org/briar/website/-/issues/32Public roadmap2021-02-17T01:04:47ZakwizgranPublic roadmapUser feedback: "It would be nice if your web site listed planned versions and added features so users could know what capabilities are in the pipeline."
The closest we currently have is this:
https://code.briarproject.org/briar/briar/w...User feedback: "It would be nice if your web site listed planned versions and added features so users could know what capabilities are in the pipeline."
The closest we currently have is this:
https://code.briarproject.org/briar/briar/wikis/product-backlogCleopatraCleopatrahttps://code.briarproject.org/briar/briar/-/issues/1531Update threat model document2020-11-15T18:57:13ZakwizgranUpdate threat model documentThe [threat model document](https://code.briarproject.org/briar/briar/wikis/threat-model) on the wiki is out of date, and it doesn't mention the goal of concealing the fact that Briar is being used. The document should be updated.The [threat model document](https://code.briarproject.org/briar/briar/wikis/threat-model) on the wiki is out of date, and it doesn't mention the goal of concealing the fact that Briar is being used. The document should be updated.CleopatraCleopatrahttps://code.briarproject.org/briar/briar/-/issues/1472Explain how Briar is different (rename the "blog"?)2022-11-18T17:24:07ZBjarni Rúnar EinarssonExplain how Briar is different (rename the "blog"?)Hi! Thanks for Briar, I'm very impressed with what you've done so far.
I was testing it for a bit (the wife and I now have the world's most secure shopping-list app!), and I wanted to share my first impression before it fades. Please fe...Hi! Thanks for Briar, I'm very impressed with what you've done so far.
I was testing it for a bit (the wife and I now have the world's most secure shopping-list app!), and I wanted to share my first impression before it fades. Please feel free to close this issue if you feel it's unhelpful or redundant.
Basically, my dominant feeling was confusion.
What is all this stuff? How does it work? The messages and contacts are straightforward, and the private groups as well... but the forums and blogs had me scratching my head. I still don't fully get them.
How do people discover a blog, or a forum? Are they completely public? Are they shared word-of-mouth over messages? Are there any access controls?
The fact that I couldn't edit or delete blog posts after writing a couple of inane tests was very unsettling - this goes against the expectations any normal user will have for something named "blog", and it's bad enough that after perfectly normal "test behaviour" one is likely going to be forced to delete one's account and start over because anyone with a quirky (let alone risque) sense of humour is likely to write "test posts" that absolutely shouldn't stay on the public record.
I'm technical enough to understand that a lot of this has to do with the underlying p2p distribution, and is also likely emergent from the design goal of making things censorship resistant. But for someone less technical, these limitations are simply baffling and disconcerting. They're also a major roadblock to adoption - I will never use a blog like this as a casual, social tool for expressing myself, and I would strongly recommend against their use to anyone else as well. For personal safety, being able to edit and delete and curate ones' public identity is vital.
There is absolutely a place and a need in this world for a feature like this - but my personal feeling is it needs to be carefully explained and shouldn't be called "blog", as that word implies all sorts of casual social interactions which this is simply inappropriate for (in its current iteration).
But obviously these are just my opinions, I hope they're helpful!CleopatraCleopatrahttps://code.briarproject.org/briar/briar/-/issues/1312Include user manual in app2022-11-18T17:32:16ZakwizgranInclude user manual in appA user asked for the manual to be included in the app. This was always the plan but it doesn't look like we had a ticket for it.
Related to #94, #315.A user asked for the manual to be included in the app. This was always the plan but it doesn't look like we had a ticket for it.
Related to #94, #315.CleopatraCleopatrahttps://code.briarproject.org/briar/website/-/issues/10Update APK download page2021-01-15T02:31:20ZakwizgranUpdate APK download pageThe direct download instructions are out of date for recent versions of Android.The direct download instructions are out of date for recent versions of Android.