Fedora Classroom · 2018. 8. 13. · Git repository: Fedora Council Docs Git repository: Quick Docs...

Presented by Adam Samalik

Fedora Classroom Writing Fedora documentation 101

Agenda

• Introduction — The new site

• Antora — The build engine

• Git — The source control

• How — The complete workflow

• Q&A

Introduction The new site

website tour

Antora The build engine

Docs Website

Component

The Structure

Docs Website

Component : Version

ModulePage

Component : Version

ModulePage

PageMenu

Docs WebsiteAntora Builder

Git repository: Installation Guide

Git repository: Release Notes

Git repository: System Admins Guide

Git repository: Fedora Council Docs

Git repository: Quick Docs

Git repository: Mentored Projects

Git repository: Fedora Modularity

Git repository: Remix Building

Git repository: CommOps https://pagure.io/fedora-docs/docs-fp-o

The Sources

https://pagure.io/fedora-docs/template

1) Component metadata

2, 3, 4) Local preview

5) Module

6) Images

7) Menu definition

8) Pages

Source Structure

Virtual Catalog of all Pages

page ID

Git The source control

1) Git structure • repository, commit, branch

2) Working with your repository • clone, commit, push, pull

3) Contributing to other repositories • fork, pull-request, merge

Installation Guide Repository

commit

commitf27

branch

master branch

f28 branch

Git StructureHEAD

Repository — The place your source lives in

Commit — A unit of change to the source

Branch — A version / variant of the source

HEAD — The current view

commit

commitf27

branch

master branch

f28 branch

Working with your repositoryHEAD

$ git clone <URL>

$ git log --graph --all --decorate

$ git checkout <BRANCH>

$ git status

$ git add <FILES>

$ git commit -m <MESSAGE>

$ git push

commit

commitf27

branch

master branch

f28 branch

Contributing to other repos…

1) Make a fork 2) New branch 3) Make changes, commit 4) Pull-request

commit

commitf27

branch

master branch

f28 branch

Your fork of the Installation Guide

Repository

commit

commit commit

commitcommit

commit

f28 branch

master branch

f27 branch

1) Make a Fork

commit

commitf27

branch

master branch

f28 branch

Repository

commit

commit commit

commitcommit

commit

f28 branch

master branch

f27 branch

Let’s make a change

in f27

commit

commitf27

branch

master branch

f28 branch

Repository

commit

commit commit

commitcommit

commit

f28 branch

master branch

f27 branch

add-something branch

2) New Branch

commit

commitf27

branch

master branch

f28 branch

Repository

commit

commit commit

commitcommit

commit

f28 branch

master branch

f27 branch

commit

3) make changes, commit

commit

f27 branch

master branch

f28 branch

Repository

commit

commit commit

commitcommit

commit

f28 branch

master branch

f27 branch

commitcommit

4) Pull-request

How The complete

workflow

Demo: Making a change to the Modularity docs

#fedora-docs (FreeNode)docs@lists.fedoraproject.org

Fedora Docs: https://docs.fedoraproject.org

Thank you!

Sources: https://pagure.io/fedora-docs

Feedback: https://goo.gl/forms/t63JjvUrT8Po3IOy1

Fedora Classroom · 2018. 8. 13. · Git repository: Fedora Council Docs Git repository: Quick Docs...

Documents

Transcript of Fedora Classroom · 2018. 8. 13. · Git repository: Fedora Council Docs Git repository: Quick Docs...

Modernising DiVA : The Integration of the Fedora Repository Software

Lab3 Intro to Git - Milwaukee School of Engineering · 2019-09-26 · Git add . Git commit -m Git push To fetch the lab3_practice repository locally

Flexible and Extensible Digital Object and Repository Architecture (FEDORA)

Git User ManualChapter 1. Repositories and Branches How to get a git repository It will be useful to have a git repository to experiment with as you read this manual. The best way

Git - Single Repository - Drexel Universitykschmidt/CS265/Lectures/Git/git-single.pdfGit - Single Repository Kurt Schmidt Intro First Repository git init git add ... The Actual Repository

Accommodating Diverse Search Requirements over a Fedora Repository Michael Durbin and Jon W. Dunn Fedora User Group – Open Repositories 2008 April 3, 2008.

GIT FOR SYSTEM ADMINS · GIT WORKFLOW STAGES Working Directory Staging Area Add Repository Commit. GIT INSTALLATION & CONFIGURATION. HOW TO INSTALL GIT ... • Local repo on your

Export from DSpace to Fedora Repository Bridge Project October 2005.

Lab 1: Trello & Git · HelloGit.txt added to Remote Repository. Basic Work Flow 1. git init 2. git remote add [repoName] [url] 3. git pull [repoName] [branch(e.g. master)] 4.

Git: Introduction Commands. 1. Create a folder and change into it 2. git init Creating local git repository. Git and files • Git keeps track of files and changes within them •

Self Hosted Web-based GIT Repository Managers

Git and GitHub€¦ · Git Branches Git Rebasing Distributed Version Control. Git and GitHub GitHub is a code hosting platform for version control and collaboration ... Git repository

mercurial Vs. Git Workﬂows - Stanford Universitysporadic.stanford.edu/bump/Gittalk.pdf · Mercurial vs. Git Workﬂows Remote Repository ... Files HEAD master $ git checkout 0906e5c

Fedora 4: The Incredible Shrinking Repository (code4lib 2014)

FEDORA Rathachai Chawuthai rathachai.chawuthai@live.com Information Management CSIM / AIT Repository Issued document 1.0.

Version Control, Part II - Git with a Shared Repository · Version Control, Part II - Git with a Shared Repository Hans-Martin von Gaudecker Collaboration ... workflows What Git has

Building Personal Collections and Networks of Digital Objects in a Fedora Repository Using VUE Anoop Kumar Nikolai Schwertner Tufts University Fedora User.

Versioning of Digital Objects in a Fedora-based Repository

Fedora Content Models for the National Science Digital Library Data Repository

Cloud Digital Repository Automation...- Fedora 4 using Amazon Web Services (AWS). A working CICD deployment staging server for Fedora 4 allows for the Fedora to maintain a streamlined