Home page

Author: loleg

docs/index.md

@@ -4,13 +4,13 @@ Driven By Data
 
 <div style="font-size: 150%;">
 
-**Dribdat** (from "driven by data") is an open source web application, featuring a playful ideation and challenge board to help organize short sprints, co-creative sessions, hackdays and [awesome hackathons](https://meta.dribdat.cc/event/2) with batteries included.
+**Dribdat** (from "driven by data") is a set of open source tools, such as a playful ideation and challenge board, to help run short sprints, creative jams, hackdays and [awesome hackathons](https://meta.dribdat.cc/project/173) based on [open data standards](https://json.everyhack.day).
 
 </div>
 <center><font style="font-size: 170%;">
 
 [🏀 Demo](https://demo.dribdat.cc/event/1)
-[📁 Download](https://github.com/dribdat/dribdat/releases)
+[📁 Install](deploy)
 [👍 Support](https://opencollective.com/dribdat/contribute)
 
 </font><img alt="Screenshot of dribdat" src="images/screenshot_awesome.png" width="100%" vspace="10">
@@ -22,9 +22,9 @@ See our [roadmap](https://github.com/orgs/dribdat/projects/8/views/2?pane=issue&
 
 # Purpose
 
-Built around Web-friendly standards like [Schema.org](https://schema.org) and [Frictionless Data](https://frictionlessdata.io), Dribdat is an (MIT licensed) part of an open source ecosystem, featuring bootstraps (authentication, file uploading, data import/export, etc.), useful workflows (announce an event - publish challenges - form teams - develop projects) and channels (social media sharing, digital signage, summary reports).
+Built around Web-friendly standards like [Schema.org](https://schema.org) and [Frictionless Data](https://frictionlessdata.io), Dribdat is an [MIT licensed](https://codeberg.org/dribdat/dribdat/src/branch/main/LICENSE) project in an open source ecosystem. It features handy bootstraps (authentication, file uploading, data import/export, etc.), useful workflows (announce an event - publish challenges - form teams - develop projects) and diverse channels (social media sharing, digital signage, summary reports).
 
-Dribdat sprints (see [Tour de Hack](tour) for some examples) typically involve open licenses ([Creative Commons](https://creativecommons.org/licenses/), [Open Data Commons](https://opendatacommons.org/licenses/odbl/), etc.), community-developed templates ([School of Data Pipeline](https://schoolofdata.org/methodology/)), and governance instruments ([Hack Code of Conduct](https://hackcodeofconduct.org/)).
+Dribdat sprints (see [Tour de Hack](tour) for some examples) typically involve open licenses ([Creative Commons](https://creativecommons.org/licenses/), [Open Data Commons](https://opendatacommons.org/licenses/odbl/), etc.), community-developed templates ([School of Data Pipeline](https://schoolofdata.org/methodology/)), or governance instruments ([Hack Code of Conduct](https://hackcodeofconduct.org/)).
 This is the official platform of [Opendata.ch - Swiss chapter of Open Knowledge](https://opendata.ch), and has been used to host dozens of events in the Swiss [open data](https://hack.opendata.ch), [open hardware](https://now.makezurich.ch), and [open source](https://hacknight.dinacon.ch) community.
 
 Our project started from a [Cookiecutter](https://www.cookiecutter.io/), striving in itself to be an example of a hackable project that can be adapted to other needs and causes.
@@ -37,6 +37,7 @@ There is more on this in the [User Guide](usage) and [Whitepaper](whitepaper).
 <center><a href="https://opencollective.com/dribdat/donate" target="_blank"><img src="https://opencollective.com/dribdat/donate/button@2x.png?color=blue" width=300 /></a>
 <font style="font-size: 140%">
 <br><a href="https://alternativeto.net/software/dribdat/" target="_blank">♥️ Heart on AlternativeTo</a>
+<br><a href="https://codeberg.org/dribdat/dribdat" target="_blank">⭐ Favorite on Codeberg</a>
 <br><a href="https://github.com/dribdat/dribdat" target="_blank">⭐ Star us on GitHub</a>
 </font></center>
 
@@ -48,4 +49,5 @@ Please use our [discussion forum](https://github.com/orgs/dribdat/discussions) o
 
 - Subscribe to get updates on our [OpenCollective](https://opencollective.com/dribdat/updates), where you can also support our development.
 - Find a sampling of Dribdat-powered events at [Tour de Hack](tour) and [OpenCollective Events](https://opencollective.com/dribdat/events) 🏀
+- Edit this Livemark-powered [documentation site](https://codeberg.org/dribdat/docs) or other projects.
 - Get in touch with [the maintainers](mailto:dribdat@datalets.ch) if you'd like to get help accelerating your community!

docs/usage.md

@@ -28,9 +28,13 @@ A typical Dribdat-powered event (this is from [GLAMhack](https://hack.glam.opend
 
 ### Leap into action
 
-Use your project page to document what makes your ideas tick. Post a creative 30-second **Pitch** using plain text or [Markdown](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) - there is an editor you can activate which helps you learn this widely used formatting style. Enable **Presentation mode** to turn your pitch into slides, or upload a PDF if you prefer.
+Use your project page to document what makes your ideas tick. Post a creative 30-second **Pitch** using plain text or [Markdown](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet). There is an editor you can activate which helps you learn this widely used formatting style. 
 
-You can add links to sound or video clips, embed documents or a slideshow hosted on [Speaker Deck](https://speakerdeck.com/) and similar. Content from many other [supported sites](https://oembed.com/#section7) will turn into a live preview.
+Feeling hacky? Use the Pitch to write your presentation with a few simple statements and [Marpit Markdown](https://marpit.marp.app/markdown) formatting, then **✓ Enable slide mode**.
+
+If you upload a PDF as your presentation, or link to a website (look for a [Publish to Web](https://knowledge.workspace.google.com/kb/publish-docs-sheets-slides-or-forms-as-web-pages-000008504) or [Embed code](https://support.microsoft.com/en-us/office/embed-a-presentation-in-a-web-page-or-blog-19668a1d-2299-4af3-91e1-ae57af723a60)), this will also be shown at the top of your project.
+
+You can add links to sound or video clips, embed documents or a slideshow hosted on a site like [Speaker Deck](https://speakerdeck.com/). Content from many [supported sites](https://oembed.com/#section7) will turn into a live preview.
 
 The picture below explains the various parts of a typical challenge or project page: