Opensource.com
opensource.com › article › 20 › 7 › docsify-github-pages
How to create a documentation site with Docsify and GitHub Pages | Opensource.com
July 28, 2020 - Use Docsify to create documentation web pages to publish on GitHub Pages.
GitHub
docs.github.com › en › pages
GitHub Pages documentation - GitHub Docs
GitHub Pages turns any GitHub repository into a live website—no separate hosting required. ... GitHub Pages supports using custom domains, or changing the root of your site's URL from the default, like octocat.github.io, to any domain you own. ... Jekyll is a static site generator with built-in support for GitHub Pages. ... If Jekyll encounters an error building your GitHub Pages site locally or on GitHub, you'll receive an error message with more information.
How to efficiently build a portfolio on Github?
I'm on a hiring panel and often look at github accounts for potential candidates. So to answer your question "add a repository" or "create a new project". Those are two different things. A repository is essentially your code, it's a place to store (and version) your code. In github speak, a project is how you track the work associated with your repo. But the repo is actual code itself, if that makes sense. Rather than simply using github as a way to upload source code, I would encourage you to learn git and specifically how to make regular commits as part of your workflow. Version control is a key tool for software developers and will provide you with a lot of value, even in school. If you're not too familiar with git, please see the free code school course on git https://www.codeschool.com/courses/try-git Things that I look for when looking at git repos: Is there a readme page that explains the purpose of the repo. This should also include documentation on how to run the code. Are there unit tests (or any tests) as part of the repo. How many commits are made on the repo? Github exposes all the git commit history. It's nice to be look at a project and see how it has grown over time. Rather than a single commit with "here's the code". I look at commit messages. Are they useful? Do they provide value and express the reason for the change or is something like "changed shit" (which is a horrible commit message btw). Groupings . A repo should represent a single project, and sometimes I see a single repo with just hundreds of random code files that are in no way related. Most importantly I pick a few random files and look at the code, is it following common standards. Does it follow conventions and styles? How easy is it to read? Are there comments? Are there too many comments? Basically looking for items from the book code complete (which is a great book btw). When it comes to code, some things to keep in mind: Don't have long blocks of commented out code. This is just a waste of space and adds visual bloat. If you're worried about losing that code, it won't be lost if you use git correctly and have several commits. you can always go back in git. Variable names. Are the names meaningful and express intent or is it something like "int something1; int something2" which provides me no context. Duplication. Is there a lot of duplication in the code? Could it be rewritten in a way to follow the DRY principle(don't repeat yourself.) Comments that state the obvious. for example //returns the count int getCount(){ return _counter; } That comment is useless because it's redundant. I hope this was helpful. Good luck! More on reddit.com
Using github for technical documentation writing. How to do it?
I don’t mean to be blunt, but the scope of this question is too broad to provide you useful information (IMO). So my suggestion is: Do some self guided research on this topic Come back with more specific questions I think you’ll get more useful replies if you spend 0.5-1 day on step one. More on reddit.com
14:40
How to Host a Website on GitHub Pages | Step-By-Step - YouTube
08:13
Using GitHub Wiki for Software Development Documentation - YouTube
08:30
How to Generate Documentation Sites with GitHub and Docsify - YouTube
06:42
Make awesome looking documentation site with an open source Docsify ...
01:28:12
GitHub for Documentation, by Rhonda Glennon - YouTube
23:21
How GitHub uses GitHub to document GitHub - YouTube
Medium
wise4rmgodadmob.medium.com › how-to-create-a-documentation-site-with-docsify-and-github-pages-doc-as-a-code-c419c44e99b7
How to create a documentation site with Docsify and Github Pages (Doc as a code) | by Nwokocha Wisdom Maduabuchi | Medium
December 3, 2020 - In this article, you will learn about GitHub pages, Docsify, documentation, technical writing, Doc as code, and how to create technical documentation with Doctify and Github pages. There are so many docs as code tools/ templates but in this article i will use Docsify, below are the few static site generators for doc as code. Docsify: generates your documentation website on the fly. Unlike GitBook, it does not generate static Html to learn more about Docsify click here · Mkdocs: builds completely static HTML sites that you can host on GitHub pages, Amazon S3, or anywhere else you choose.
GitHub
docs.github.com › en › pages › quickstart
Quickstart for GitHub Pages - GitHub Docs
Under "Build and deployment", under "Branch", use the branch dropdown menu and select a publishing source. Optionally, open the README.md file of your repository. The README.md file is where you will write the content for your site.
GitHub
docs.github.com › en › pages › getting-started-with-github-pages › creating-a-github-pages-site
Creating a GitHub Pages site - GitHub Docs
If you use a custom build process or a static site generator other than Jekyll, you can write a GitHub Actions workflow to build and publish your site. GitHub provides workflow templates for several static site generators.
Docascode
docascode.github.io › template › tutorial › getting-started
Getting Started
The easiest way to install docfx is to use .NET Tools. Install the latest version of .NET SDK and run: ... Or you can download from GitHub Releases. Open a command shell, and enter the following command: ... The preceding command creates a new documentation project. The -o mydocs parameter creates a directory named mydocs with the project files inside. ... After the command shell indicates that the website has started, browse to https://localhost:5001.
Medium
proandroiddev.com › how-to-create-a-documentation-website-for-your-project-with-github-actions-mkdocs-and-dokka-250c881e6f40
How to create a documentation website for your project with GitHub Actions, mkdocs, and Dokka
March 10, 2024 - Setup Pages, Upload artifact, Deploy to GitHub Pages — steps we need for GitHub Pages deployment · As a result of this workflow, we have a URL to our website. If you want to make your documentation with private access, shield by authorization, and manage access for that you probably need to set up your server. For that, you can build a Docker image.
DEV Community
dev.to › michaelcurrin › how-to-build-a-docs-site-4h42
How to build a docs site - DEV Community
May 20, 2020 - You've got a Github repo with a docs folder, but it is disappointingly bland. How do you make it better? You can turn it into a docs site. But how do you make sure to... ... So some good solutions for building a docs site that meets these requirements are Jekyll, Docsify.js and MkDocs.
GitHub
github.blog › home › developer skills › publish your project documentation with github pages
Publish Your Project Documentation with GitHub Pages - The GitHub Blog
June 24, 2021 - When it comes to documentation, a path with less resistance is often the better approach. GitHub Pages gives you a direct path to create websites for your projects, which makes it a natural choice for publishing and maintaining documentation. Because GitHub Pages supports Jekyll, you can pen your documentation in plain text or Markdown to help maintain a lower barrier to contribution.
GitHub
github.com › topics › documentation-site
documentation-site · GitHub Topics
A simple, fast, free & easy to use static based plain HTML template. That allows you to make a beautiful personal / blog or technical documentation website really quickly.
.NEXT
dotnet.github.io › docfx
Quick Start | docfx - Microsoft .NET - GitHub Pages
Build your technical documentation site with docfx. Converts .NET assembly, XML code comment, REST API Swagger files and markdown into rendered HTML pages, JSON model or PDF files.
Docsify
docsify.js.org
docsify
Unlike most other documentation site generator tools, it doesn't need to build HTML files. Instead, it dynamically loads and parses your Markdown files and displays them as a website. To get started, create an index.html file and deploy it on GitHub Pages (for more details see the Quick start ...