perkeep/doc/README.md

64 lines
3.1 KiB
Markdown

# Documentation
* [Overview](/doc/overview.md): The original motivation and background for why
Camlistore exists and what one might use it for.
## For Users
**If you're just looking to set up a Camlistore server and use it yourself,
check out our [getting started guide](/download).** 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](/cmd/)
* [Server Config](/doc/server-config.md): Details for configuring server storage
and access, including synchronization to other Camlistore servers or backup
to cloud storage providers
* [Client config](/doc/client-config.md): Clients need this configuration file to
securely connect to your Camlistore server(s)
## For Developers
If you want to help the development of Camlistore or just want to know more
about the how and why behind Camlistore, these docs are the going to help you
get started. **Something we didn't cover here that you're interested in?** Ask
on the [mailing list](https://groups.google.com/group/camlistore).
### Concepts
* [Principles](/doc/principles.md): our base principles, goals, assumptions
* [Terminology](/doc/terms.md): let's agree on terms to stay sane
* [Use Cases](/doc/uses.md): what one might do with all this (or at least our aspirations)
* [Prior Art](/doc/prior-art.md): other projects with similar goals or strategies
* [Contributing](https://camlistore.org/doc/contributing): how to help
* [Style guide](/doc/web-ui-styleguide.md) for the Web UI
### Technical Docs
* [Packages](/pkg/): internal API documentation
* [Architecture](/doc/arch.md): the pieces, layers, and how they interact
* [Schema](/doc/schema/): how we model data in Camlistore
* [JSON Signing](/doc/json-signing/)
* [Sharing](/doc/sharing.md)
## Presentations {#presentations}
* 2016-04, **GDG Seattle**: [[slides]](https://docs.google.com/presentation/d/1AmT5DAL9CrzQFS22i0xJ5SYtXQfrHqOyYiQB7imshdw/view) [[video]](https://www.youtube.com/watch?v=dg6OmoKNbcw)
* 2016-04, **LinuxFest Northwest**: [[slides]](https://docs.google.com/presentation/d/1AmT5DAL9CrzQFS22i0xJ5SYtXQfrHqOyYiQB7imshdw/view) [[video]](https://www.youtube.com/watch?v=8Dk2iVlc67M)
* 2015-02, **FOSDEM**: [[slides]](https://go-talks.appspot.com/github.com/mpl/talks/fosdem-2015/fosdem-20150201.slide) [[video]](https://www.youtube.com/watch?v=oM-MfeflUZ8)
* 2014-02, **FOSDEM**: [[slides]](http://go-talks.appspot.com/github.com/mpl/talks/fosdem-2014/2014-02-02-FOSDEM.slide) [[video]](https://www.youtube.com/watch?v=kBCQq5hfsug) [[WebM]](http://video.fosdem.org/2014/K4601/Sunday/Camlistore.webm)
* 2013-06, **Google Developers Live**: [[video]](https://www.youtube.com/watch?v=yxSzQIwXM1k)
* 2011-05, **São Paolo Perl Conference**: [[slides]](/talks/2011-05-07-Camlistore-Sao-Paolo/)
* 2011-02, **First Introduction**: [[slides]](https://docs.google.com/present/view?id=dgks53wm_2j86hwnhs)
## Video tutorials {#tutorials}
* 2014-03, [Getting started with Camlistore](https://www.youtube.com/watch?v=RUv-8PhnNp8)
* 2014-03, [Getting started with camput and the Camlistore client tools](https://www.youtube.com/watch?v=DdccwBFc5ZI)