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

remove discord from documentations #47

Merged
merged 1 commit into from
Nov 3, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 4 additions & 22 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,12 +20,12 @@ A community like this should be **open**, **considerate** and **respectful**.

Behaviours that reinforce these values contribute to a positive environment, and include:

* **Being open**. Members of the community are open to collaboration, whether it's on PEPs, patches, problems, or otherwise.
* **Being open**. Members of the community are open to collaboration.
* **Focusing on what is best for the community**. We're respectful of the processes set forth in the community, and we work within them.
* **Acknowledging time and effort**. We're respectful of the volunteer efforts that permeate the Python community. We're thoughtful when addressing the efforts of others, keeping in mind that often times the labor was completed simply for the good of the community.
* **Acknowledging time and effort**. We're respectful and thoughtful when addressing the efforts of others, keeping in mind that often times the labor was completed simply for the good of the community.
* **Being respectful of differing viewpoints and experiences**. We're receptive to constructive comments and criticism, as the experiences and skill sets of other members contribute to the whole of our efforts.
* **Showing empathy towards other community members**. We're attentive in our communications, whether in person or online, and we're tactful when approaching differing views.
* **Being considerate**. Members of the community are considerate of their peers -- other Python users.
* **Being considerate**. Members of the community are considerate of their peers.
* **Being respectful**. We're respectful of others, their positions, their skills, their commitments, and their efforts.
* **Gracefully accepting constructive criticism**. When we disagree, we are courteous in raising our issues.
* **Using welcoming and inclusive language**. We're accepting of all who wish to take part in our activities, fostering an environment where anyone can participate and everyone can make a difference.
Expand Down Expand Up @@ -68,7 +68,7 @@ If your suggestion can not be found already, see if it is already covered by our

## πŸ“Ÿ Communication

To get in touch with the community join our [Discord](https://img.shields.io/discord/793235453871390720) or write use on Mastodon: [@[email protected]](https://mastodon.cloud/@photos).
To get in touch with the community or write use on Mastodon: [@[email protected]](https://mastodon.cloud/@photos).



Expand All @@ -82,21 +82,3 @@ Underneath it is using these frameworks:
* [tower](https://github.com/tower-rs/tower) - for networking
* [axum](https://github.com/tokio-rs/axum) - as web framework
* [abi_stable](https://github.com/rodrimati1992/abi_stable_crates) - FFI for dynamic library loading



## πŸ’» Build & Run

To build and run the core

```shell
$ cargo run
```

### πŸ”¬ Verifications

To run tests

```shell
$ cargo test
```
57 changes: 14 additions & 43 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,6 @@

[![License](https://img.shields.io/github/license/photos-network/core?style=for-the-badge)](./LICENSE.md)
[![GitHub contributors](https://img.shields.io/github/contributors/photos-network/core?color=success&style=for-the-badge)](https://github.com/photos-network/core/graphs/contributors)
[![Discord](https://img.shields.io/discord/793235453871390720?style=for-the-badge)](https://discord.gg/dGFDpmWp46)
![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/photos-network/core/check.yaml?style=for-the-badge)


Expand Down Expand Up @@ -30,70 +29,42 @@ It is responsible for main tasks e.g.:



## 🧩 Contribution

This is a free and open project and lives from contributions of the community.

See our [Contribution Guide](CONTRIBUTING.md)



## πŸ§ͺ Development

The core is written in πŸ¦€ [Rust](https://rust-lang.org/) and highly customizably by using a Plugin-system.



#### πŸ“„ Documentation
#### πŸ”¬ Testing

With the nightly version of `cargo doc` an additional index-page will be created.
To run tests for all crates in this workspace, run:
```shell
$ RUSTDOCFLAGS="--enable-index-page -Zunstable-options" cargo +nightly doc --all --no-deps --document-private-items --all-features
$ cargo test --workspace --all-targets
```



#### πŸ”¬ Testing

An continuous check on all files is done in the background and will trigger `cargo test` on each file change.
Run continuous checks on a specific crate during development.

```shell
$ cargo watch --exec test
$ cargo watch --exec 'test -p media'
```

To run tests for all crates in this workspace, run:
```shell
$ cargo test --workspace --all-targets
```

### Visual Studio Code

The fastest start into development can be archived by using [Visual Studio Code](https://code.visualstudio.com/) and [Docker](https://www.docker.com/get-started).
## πŸ“œ Roadmap (MvP)

1. Install [Docker](https://www.docker.com/get-started)
2. Install [Visual Studio Code](https://code.visualstudio.com/)
3. Install [Visual Studio Code Remote - Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers)
4. Clone and Open this repository in Visual Studio Code
5. Click the "Reopen in Container" Dialog
6. Launch **Photos.network** from the `RUN` window.
- Create a new media item
- Upload one or multiple images
- Download a list of owned media items
- Download the original file for a specific media item
- Authenticate via openID

![VS Code with devcontainers](vscode.gif)


## 🧩 Contribution

## πŸ“œ Roadmap (MvP)
This is a free and open project and lives from contributions of the community.

- Authenticate via openID
- Create a new media item
- Upload one or multiple photos
- Download a list of owned media items
- Download the original photo from a specific media item
- *Metadata (size, resolution)
- *EXIF (orientation, image taken timestamp, last modified, camera)
- *RAW (image support for RAW-images)
- *Resize (create low-resolutions / thumbnails)
- *Deep learning (image recognition, Reinforcement learning)
- *Plugin System (extract features into plugins)
See our [Contribution Guide](CONTRIBUTING.md)



Expand Down
Loading