mirror of https://github.com/perkeep/perkeep.git
d6a0b05df0
Part of the project renaming, issue #981. After this, users will need to mv their $GOPATH/src/camlistore.org to $GOPATH/src/perkeep.org. Sorry. This doesn't yet rename the tools like camlistored, camput, camget, camtool, etc. Also, this only moves the lru package to internal. More will move to internal later. Also, this doesn't yet remove the "/pkg/" directory. That'll likely happen later. This updates some docs, but not all. devcam test now passes again, even with Go 1.10 (which requires vet checks are clean too). So a bunch of vet tests are fixed in this CL too, and a bunch of other broken tests are now fixed (introduced from the past week of merging the CL backlog). Change-Id: If580db1691b5b99f8ed6195070789b1f44877dd4 |
||
|---|---|---|
| .. | ||
| example-blobs | ||
| json-signing | ||
| protocol | ||
| publishing | ||
| release | ||
| schema | ||
| todo | ||
| README.md | ||
| app-environment.md | ||
| arch.md | ||
| client-config.md | ||
| environment-vars.md | ||
| overview.md | ||
| overview.txt | ||
| principles.md | ||
| prior-art.md | ||
| release.txt | ||
| search-ui.md | ||
| search-ui.txt | ||
| server-config.md | ||
| sharing.md | ||
| status.md | ||
| storage-examples.md | ||
| terms.md | ||
| uses.md | ||
| web-ui-styleguide.md | ||
README.md
Documentation
- Overview: The original motivation and background for why Perkeep exists and what one might use it for.
For Users
If you're just looking to set up a Perkeep server and use it yourself, check out our getting started guide. The documents below go into more detail on customizing the high level configuration for use such as alternative blob storage or synchronization to cloud storage.
- Command-line tools
- Server Config: Details for configuring server storage and access, including synchronization to other Perkeep servers or backup to cloud storage providers
- Client config: Clients need this configuration file to securely connect to your Perkeep server(s)
For Developers
If you want to help the development of Perkeep or just want to know more about the how and why behind Perkeep, these docs are going to help you get started. Something we didn't cover here that you're interested in? Ask on the mailing list.
Concepts
- Principles: our base principles, goals, assumptions
- Terminology: let's agree on terms to stay sane
- Use Cases: what one might do with all this (or at least our aspirations)
- Prior Art: other projects with similar goals or strategies
- Contributing: how to help
- Style guide for the Web UI
Technical Docs
- Packages: internal API documentation
- Architecture: the pieces, layers, and how they interact
- Schema: how we model data in Perkeep
- Protocol: blob server protocol API
- JSON Signing
- Sharing
Presentations
- 2016-04, GDG Seattle: [slides] [video]
- 2016-04, LinuxFest Northwest: [slides] [video]
- 2015-02, FOSDEM: [slides] [video]
- 2014-02, FOSDEM: [slides] [video] [WebM]
- 2013-06, Google Developers Live: [video]
- 2011-05, São Paolo Perl Conference: [slides]
- 2011-02, First Introduction: [slides]