Git Product home page Git Product logo

website's Introduction

Data Together Website

GitHub Slack Jenkins

A static-generated website to introduce the Data Together project, built with Hugo. The website describes our collective commitment to support the development of a decentralized web that aggregates and preserves the public record, with attention to provenance and trustworthiness of our data.

License

Copyright (C) 2017 Data Together contributors.

Data Together theme code at github.com/datatogether/website/themes/datatogether is licensed under a GNU General Public License v3.0, the text of which is included in the repository here.

Data Together website content and documentation is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License.

Getting Involved

We would love involvement from more people! If you notice any errors or would like to submit changes, please see our Contributing Guidelines.

We use GitHub issues for tracking bugs and feature requests and Pull Requests (PRs) for submitting changes.

Development

  1. Clone this repo

    $ git clone [email protected]:datatogether/website.git
    

    and cd into the directory

  2. Install Hugo

    We use Hugo, a fast and modern static site generator written in Go, follow the install instructions.

  3. Make Changes and Test Locally

    You can then make changes using your favourite text editor, read about Hugo usage basics and directory structure.

    Hugo also includes a development server, so you can view your changes as you go. Spin it up with the following command:

    $ hugo server
    

    run hugo before adding changes to a git commit.

Dependencies

Deployment

Data Together is currently hosted on Github Pages with automatic deployment via Circle CI (deployment logs). Any changes merged into main will automatically go live onto the website.

website's People

Contributors

frijol avatar lightandluck avatar b5 avatar dcwalk avatar rgardaphe avatar allenpg avatar victorb avatar bmn4d avatar titaniumbones avatar flyingzumwalt avatar

Stargazers

farough avatar  avatar  avatar Seamus Tuohy avatar Michael Hucka avatar jon ⚝ avatar  avatar  avatar Jonathan Brier avatar

Watchers

 avatar  avatar James Cloos avatar  avatar Michael Hucka avatar  avatar  avatar

website's Issues

Some links are broken on `/readings` page

The join link and links to semester notes are broken on https://datatogether.org/readings/. They point to github page urls: datatogether.github.io that respond with a 404. Not sure how to fix this correctly. But think it might have to do with config.toml.

Screen Shot 2019-11-07 at 12 32 59 PM

I don't understand how the github page interacts with the .org site, but there seems to be re-direction of some kind. This link https://datatogether.github.io/website/posts/02_civics/ on the "alternatives" blog post re-directs and does work for some reason

/cc @Frijol

[Home] Copy Edits

From @mhucka in #12:

"We hope to build a future in which networks of collaborators make their data accessible to their peers, immediately discoverable, easily verifiable, and robustly preserved."

Minor grammatical issue: the referent of "immediately discoverable" and the tail end of that sentence strike me as ambiguous. Here are some ideas for how to avoid the problem:

  • Replace the comma after "peers" with a long dash (using whichever "long dash" convention is being used throughout the project, whether that's an em-dash without spaces or an en-dash surrounded by spaces)
  • Add the words "in ways that are" before "immediately"
  • Replace the comma after "peers" with "and the data is" (or "and the data are" if we're following the tradition that "data" is considered plural)

"Creating proof-of-concept tools that communities can use to collectively steward data"

Split infinitive. Suggested replacement: "to steward data collectively".

"There are many ways to get involved and to contribute, the most important of which is to test the Data Together model with your community and then share back where things work, where the approach opens new possibilities, and where there’s room for improvement."

The expression "share back" sounds weird. How about "share your experiences about"?

The Mystery of the Missing Readings Page

"Readings" page doesn't show up on the deployed site (in the menu or as a /readings page), even though it works fine from a local version on master branch.

Screen Shot 2019-10-28 at 1 28 34 PM
Screen Shot 2019-10-28 at 1 27 48 PM

Deploy issue perhaps?

[Home] Remove Keynote presentations

Hey there, thank you for submitting an issue!

We are trying to keep issues for feature requests and bug reports. Please complete the following checklist before creating a new one:

  • feature request

Just noticing when cloning the repo that it is quite large, the keynote presentations are over 20MB, wondering if we just switch to pdf-only as those can be reduced in size?

If we want to publish presentation materials that are editable maybe we consider a different publishing approach (... 😏 ) rather than surfacing/storing in the website repo

Add mission to the website

"Data Together empowers people to create a decentralized civic layer for the web, leveraging community, trust, and shared interest to steward data they care about." from our docs

We should have our own 404

When we 404 we get the github pages 404, it would be much better to have something with at least our nav bar at the top

Unpublished trust and private data blog posts

Just a heads up that I set the publish date for the trust (d1ab133) and private data (ebd8700) posts after the new year because they're still stubs and I'm not sure what the planned publishing date is. The trust blog was appearing on the live site.

Let's close this issue whenever the correct date is put in for them?

Automatic builds and deploys via Jenkins?

Hello there!

We're currently making all websites under ipfs/libp2p/ipld/multiformats be automatically built and deployed via Jenkins.

If wanted, we could also activate that for this website. This would give you a link to a preview (via IPFS) for each commit and PR and also automatically update the _dnslink TXT record when changes to master happened. Makes maintenance of the website super simple!

Let me know if we should activate that for this repository as well.

Revisit dependencies and remove extra libraries, partials, etc...

Hey there, thank you for submitting an issue!

We are trying to keep issues for feature requests and bug reports. Please
complete the following checklist before creating a new one:

  • feature request

Just poking about and it looks like we have jquery and maybe normalize twice, footer scripts and more that are not relevant to this site.

I feel like this setup was pulled over from another site and we can probably revisit and clean up?

Improve formatting for blog readability

There are some oddities of text width, spacing, and maybe font size that make our blog a bit hard to read. It would be very nice to have someone take a look at/tweak these!

I'd be happy to help/implement if someone with more design chops could take a look and call out what needs changing!

Screen Shot 2019-06-05 at 1 39 07 PM
Screen Shot 2019-06-05 at 1 39 00 PM

[public record] More explanation and examples for Public Record

Aggregators vs Public Record (line is blurry)
The role of a Public Record in enabling discovery

Examples of Public Records

need to build out this list

Examples of aggregated datasets used to view and track data that is being stored by many parties.

Tools for Maintaining a Public Record

need to build out this list

Website is down

Flagging that the website is down and has been for about a week (or more?).

Based on chat in Slack (thanks @Mr0grog @lightandluck @b5) our site is pinned to the IPFS public gateway (http://gateway.ipfs.io/), which is working, and our dnslink records are right, but the hash is failing to resolve.

New Theme needs >= Hugo 0.55

The CircleCI build failed because we're using an image for Hugo 0.46, and the new theme just merged (#86) requires Hugo 0.55

Updating my local version of Hugo to latest (0.60) and testing. And will update our image if it works ok.

Add README and Templates

Make sure this repo has the following files:

  • Readme README.md
    • Repo Badges for: Github Project, Slack, License
    • 1-3 sentence description of repository contents
    • Getting Involved section
    • Development section
  • License -- LICENSE
  • Contributing Guidelines (minimal and pointing to org-wide) .github/CONTRIBUTING.md
  • Issue Template -- .github/ISSUE_TEMPLATE.md
  • GitHub Description from 1-3 sentence readme blurb

This issue forms part of a project-wide meta-issue

Publishing Updates

I think we should avoid constantly having to bother @lgierth to repoint the IPNS entry for this page on updates. Some options include:

  • replicate a script like the one contained in ipfs/website that makes updates extra easy for someone at protocol to perform
  • we set up an IPFS gateway, request a one time DNS point at the IPNS entry of that gateway, self-manage updates
  • switch to a "more traditional" static hosting solution 😢

Adding a blog to the site

Now that we have a blog post nearly ready we need a venue for it! Hugo is set up to be a blogging platform, so it seemed reasonable to add that capacity to our site.

What do we need to take into consideration when spinning up blogging for Data Together?

The simplest version (in the blog branch) is just to add the blog as a page, which looks like:

menu:
Screen Shot 2019-05-21 at 1 59 23 PM

post:
Screen Shot 2019-05-21 at 1 59 39 PM

file structure:
Screen Shot 2019-05-21 at 2 11 00 PM

This would make more sense (menu-wise) if we deleted the other menu links (Data Together, which goes to the homepage (but is also linked in the header), and Public Record, which I'm confused about.

Feel free to check out/play with the blog branch but note that the content and formatting of the post is from the rough draft/will be edited before posting.

Switch to a different build and deploy process

It has taken ~7months to work through an automated deploy process, and it doesn't appear as if it current works.

Can we build and deploy on a non-IPFS solution while we get an automated process sorted out, given the complexity of this site (low), and the centrality of our hopes to have it used for engagement and messaging (increasing, see datatogether/datatogether#34)?

This could be:

  • manual builds onto gh pages
  • automated builds onto gh pages
  • ?? something fancy on our own VPS?

[Home] Switch out 3 "Wheres" to 5W question format

Looking at this chunk:

There are many ways to get involved and to contribute, the most important of which is to test the Data Together model with your community and then share back where things work, where the approach opens new possibilities, and where there’s room for improvement.

I made a comment in the google doc draft:

This needs handholds -- like do we have a worksheet-styled doc "use the model"?
Not sure I'd suggest 3 wheres... think we'd want a 5W almost as a guide to report back (this could be part of a "worksheet" as above?)

With an excellent follow up comment (TBD if I can post publicly)

Some additional resources I dug up around 5W activities:

Update reading/semester_2 after end of semester

We're pushing this live before the semester closes so will need to grab:

  • Stewardship blog post link
  • Decentralization notes link
  • Decentralization recording link
  • Decentralization blog post link

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.