Skip to content
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

Updated README.md and installation files #184

Merged
merged 14 commits into from
Sep 29, 2022
Merged

Updated README.md and installation files #184

merged 14 commits into from
Sep 29, 2022

Conversation

donpui
Copy link
Contributor

@donpui donpui commented Sep 28, 2022


Code Review Checklist

  • Description accurately reflects what changes are being made.
  • Description explains why the changes are being made (or references an issue containing one).
  • The PR appropriately sized.
  • New code has enough tests.
  • New code has enough documentation to answer "how do I use it?" and "what does it do?".
  • Existing documentation is up-to-date, if impacted.

@donpui donpui requested a review from ewanas September 28, 2022 12:41
README.md Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
@donpui donpui marked this pull request as ready for review September 28, 2022 13:37
@ewanas ewanas requested a review from meejah September 28, 2022 15:09
Copy link
Collaborator

@meejah meejah left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Some inline comments. Address as you see fit.

README.md Show resolved Hide resolved
- [x] Windows
- [x] OSX
- [x] macOS
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

MacOS I think is the preferred capitalization?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have checked, Apple use now macOS brand name to match, iOS, tvOS, watchOS: https://support.apple.com/macos

Also here some more info about branding: https://www.macworld.com/article/672681/list-of-all-macos-versions-including-the-latest-macos.html

README.md Outdated

### Installation

You can find detailed instructions on how to install applications on various platforms [here](https://github.com/LeastAuthority/destiny/blob/main/doc/installation.md)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I always prefer to avoid "here" link-text.

Maybe "We have [detailed instructions on how to install] the application on various platforms." (with the stuff in "[" being the link).

README.md Outdated

### Verification

We recommend verifying every downloaded file. Instructions [here](https://github.com/LeastAuthority/destiny/blob/main/doc/releases.md).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Similar comment for this. Maybe "We recommend [verifying every downloaded file] against the corresponding signature".

README.md Outdated
```

More information on signing releases can be found [here](https://github.com/LeastAuthority/destiny/blob/main/doc/releases.md)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe "There are further [details of our signing process] available."

README.md Outdated

## Other

- **FAQ** can be found [here](https://github.com/LeastAuthority/destiny/blob/main/FAQ.md).
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Similar, I'd try wording these so the important text is the link. like "We have an [FAQ], a [Privacy Policy], and [Terms & Conditions'." Or. to keep a list, just link like "[Our FAQ]", "Our [Privacy Policy]", etc...

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks I will update this

2. Open `destiny_android.apk` file
3. There might be a popup asking if you really want to install, press Install

**Note**: *installing directly is not recommended, also there won't be automatic updates*
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

👍

**Note**: might require additional libraries


## macOS (M1 or Intel chip based)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If the other macOS -> MacOS then this should change too.

2. Run chmod u+x `destiny_linux_amd64.AppImage && ./destiny_linux_amd64.AppImage`
**Note**: If your system does not have FUSE you can [extract the appimage](https://github.com/AppImage/AppImageKit/wiki/FUSE#type-2-appimage):
```
./nvim.appimage --appimage-extract
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This filename should be the thing downloaded, no?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Will fix

2. Extract `tar xzvf destiny_linux_amd64.tar.gz`
4. Go inside directory `destiny_linux`
5. Run `./destiny`

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If there are build instructions (e.g. for developers at least) would be good to at least link them here.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There are some instructions in main README file for building. Maybe we can improve this separately.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can we file a ticket to remember to link the build instructions here, then, at least?

README.md Outdated Show resolved Hide resolved
donpui and others added 2 commits September 29, 2022 13:29
Co-authored-by: El-Hassan Wanas <wanas@leastauthority.com>
@donpui donpui merged commit 4dca2e7 into main Sep 29, 2022
@ewanas ewanas deleted the readme-update branch September 29, 2022 10:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants