Git Product home page Git Product logo

tutorials.ubuntu.com's Introduction

tutorials.ubuntu.com

CircleCI build status Code coverage

tutorials.ubuntu.com is moving. All tutorial content has been migrated to https://discourse.ubuntu.com/c/tutorials in preparation for this move, and any updates to tutorials should now be made over there


The Polymer application that runs https://tutorials.ubuntu.com.

For anyone wishing to contribute work or file issues, please read CONTRIBUTING.md.

For technical details and help, go to HACKING.md

Running this site

The easiest way to get running is to use our ./run command. This script requires Docker to be installed on your system. For more advanced usage or information how to run without Docker, read HACKING.md.

Quick start

Start up a local server which watches serves content from the examples folder:

$ ./run

Start up a local server which watches a given file or folder for changes relative to the project root.

./run serve [file or folder]

The information presented on https://tutorials.ubuntu.com is licensed under the Creative Commons Attribution-ShareAlike 4.0 International license. The codebase of the tutorials application is licensed under the LGPLv3 by Canonical Ltd.

This code is based on ubuntu/codelabs-source (by @didrocks), which is in turn based on googlecodelabs/codelab-components. Codelab-components is licensed with the Apache License, Version 2.

tutorials.ubuntu.com's People

Contributors

aden-chrome avatar alangriffiths avatar ammarn911 avatar asaunders avatar buggtb avatar caldav avatar caleb-ellis avatar claralavina avatar deadlight avatar degville avatar didrocks avatar evilnick avatar gerboland avatar gizmo693 avatar grahambancroft avatar ivanfon avatar konrad11901 avatar leannogasawara avatar nottrobin avatar pmahnke avatar pmatulis avatar ppabcd avatar renovate-bot avatar saviq avatar sphar-io avatar steverydz avatar tytus-kurek avatar variabledeclared avatar vorlonofportland avatar willmoggridge avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

tutorials.ubuntu.com's Issues

Update page descriptions

The homepage description is "Ubuntu tutorials!" and there is none on the tutorial pages. We should do a better job of describing the page.

update report issue link

on the tutorial left side panel you have a link "Did you find a mistake? Please file a bug." which currently goes to codelabs repo.

It should go to tutorials.ubuntu.com repo

Tooltip help popup blocks content

Move the cursor anywhere on the page then let it sit idle for a few seconds. A tooltip help rectangle pops up. The text doesn't provide important information and it obscures the content of the page.

[SS] No way of returning to home

Once entered a tutorial on a mobile. There is no way to leaving the tutorial and return to the home screen.

I would expect a home link at the top of the menu in the burger slide out.

Update intro copy

Title:
Let's get coding!

Text below:
Ubuntu Tutorials are just like learning from pair programming except you can do it on your own. They provide a step-by-step process to doing development and devops activities on Ubuntu machines, servers or devices.

For now, the tutorials focus mainly on building and using snaps and Ubuntu Core. If you'd like to see tutorials cover more topics, let us know [external Link to: https://github.com/ubuntudesign/tutorials.ubuntu.com/issues/new].

Arrows overlapping content

On large screens arrows are sometimes overlapping tutorial page. It's not very consistent (sometimes it happens and sometimes not)

screen shot 2017-01-13 at 16 54 21

Missing analytics

We should have google analytics and crazy egg enabled on the site.

By adding GTM we can enable tracking as and when we need.

tutorials.ubuntu.com is inappropriate as a separate site

Ubuntu contributors have a long and unfortunate history of launching new official Web sites that overlap in purpose with existing sites. Examples include:

This seems to happen firstly because proposing, developing (especially if a specialized CMS is involved), and claiming credit for, a separate site is much easier than doing the same for a new feature of an existing site. And secondly because the Web team and IS team do not have an effective checklist to prevent it happening. It’s harmful for many reasons: it reduces the number of people who know that a particular site exists at all, dilutes search engine ranking, otherwise makes it harder to find and choose the correct site, results in inconsistent navigation through user journeys, and increases maintenance costs.

tutorials.ubuntu.com is unfortunately another example. We already have a site targeted at people developing things on Ubuntu: developer.ubuntu.com. tutorials.ubuntu.com includes custom code for navigating tutorials, and adjusting them based on reading/following and skill level. But this does not, in any way, alter the problem that it’s completely unreasonable to expect someone to know in advance whether the topic they’re interested in has been documented as a tutorial, an article, a video, or not at all. And the addition of a “Tutorials” page to developer.ubuntu.com barely helps. As well as wasting reader time, the separation wastes contributor time: for example, the developer.ubuntu.com page on setting up an Intel Joule and the tutorials.ubuntu.com tutorial on exactly the same topic seem to have been written completely independently, with not even a link between them.

This issue will be fixed when each tutorial is embedded into the relevant section of developer.ubuntu.com, and tutorials.ubuntu.com either is retired or consists only of redirects.

Fixing this issue would incidentally fix issue #67.

The project is missing a license

Hi! This project seems to be missing a license.

Its important to license a project for possible contributors and consumers alike. Also, its important to you because you don't appear to get the copyrights assigned, so making the conditions clear and explicit gives you stronger legal standing (I'm no lawyer though).

As its a collection of tutorials, I'd recommend the CC-BY-SA 3.0 license.

app-routing broken on website

For example if you open the first page, click the 2nd item so the website navigates to #2, then hit back, the page doesn't app-route back to the top

In the "Build a nodejs service" tutorial, at step 4 the app fails to run in jailmode with snapd >=2.20

I’m following the "Build a nodejs service" tutorial, and everything works fine until step 4. At that point, I’m seeing that:

$ snap try prime/ --jailmode
chuck-norris-webserver 1.0.0 mounted from […]/snap-codelabs-code/build-a-nodejs-service/start/prime

$ sudo chuck-norris-webserver.node-service
cannot snap-exec: cannot read info for "chuck-norris-webserver": stat /var/lib/snapd/snaps/chuck-norris-webserver_x1.snap: permission denied

I’m on xenial, I’ve tested both with snapd 2.20 and 2.21 (from -proposed). Same error.

The page titles dont update

The title of the site remains "Ubuntu tutorials" even when in a tutorial. We should prepend the tutorial title for better SEO.

Cards need top border-radius

I think we need something like:

border-radius: 2px 2px 0 0

on the .header.horizontal div

See attached for what it looks like in Chrome. Top left is particularly bad.

screen shot 2017-01-12 at 13 24 32

Bottom buttons cover text

At any of the tutorials, depending on the size of the window (but Im currently on laptop) the bottom button to go back covers part of the text.
button

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.