Skip to content

Commit

Permalink
feat: improve docs
Browse files Browse the repository at this point in the history
  • Loading branch information
mr-karan committed Jul 1, 2024
1 parent a01e451 commit 9d9b9b1
Show file tree
Hide file tree
Showing 8 changed files with 76 additions and 28 deletions.
19 changes: 9 additions & 10 deletions TODO.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# doggo - Initial Release Milestone
# todo

## Resolver
- [x] Create a DNS Resolver struct
Expand Down Expand Up @@ -58,19 +58,18 @@
- [x] Shell completions
- [x] zsh
- [x] fish
- [ ] Add tests for Resolvers.
- [ ] Add tests for CLI Output.
- [x] Homebrew - Goreleaser
- [ ] Add support for `dig +trace` like functionality.
- [x] Add `dig +short` short output
- [x] Add `--strategy` for picking nameservers.
- [ ] Explore `dig.rc` kinda file
- [x] Separate Authority/Answer in JSON output.
- [x] Error on NXDomain (Related upstream [bug](https://github.com/miekg/dns/issues/1198))

- [x] Reverse Lookup (dig -x)
- [x] Shell completion proper
- CLI docs
- [ ] Helper util?
- Merge those as misc docs or usage
- [ ] Example Guide
- [x] CLI docs
- [x] Merge those as misc docs or usage
- [x] Example Guide

- [ ] Add tests for Resolvers.
- [ ] Add tests for CLI Output.
- [ ] Add support for `dig +trace` like functionality.
- [ ] Explore `dig.rc` kinda file
5 changes: 4 additions & 1 deletion docs/astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,10 @@ export default defineConfig({
},
integrations: [
starlight({
title: 'Documentation',
title: 'Doggo',
customCss: [
'./src/assets/custom.css',
],
social: {
github: 'https://github.com/mr-karan/doggo',
},
Expand Down
29 changes: 28 additions & 1 deletion docs/public/favicon.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
3 changes: 3 additions & 0 deletions docs/src/assets/custom.css
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
.hero {
padding-block: unset;
}
Binary file added docs/src/assets/doggo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file removed docs/src/assets/houston.webp
Binary file not shown.
29 changes: 23 additions & 6 deletions docs/src/content/docs/index.mdx
Original file line number Diff line number Diff line change
@@ -1,18 +1,35 @@
---
title: Doggo
description: The Friendly DNS Client
template: splash
hero:
tagline: Command-line DNS client for humans
image:
file: ../../assets/houston.webp
actions:
- text: Visit Demo
link: /app/
icon: right-arrow
variant: primary
- text: Read the docs
link: /intro/installation
icon: external
---

![](../../assets/doggo.png)

## Features

- Human-readable output with color-coded and tabular format
- JSON output support for easy scripting and parsing
- Multiple transport protocols:
- DNS over HTTPS (DoH)
- DNS over TLS (DoT)
- DNS over QUIC (DoQ)
- DNS over TCP
- DNS over UDP
- DNSCrypt
- Support for `ndots` and `search` configurations from `resolv.conf` or command-line arguments
- Multiple resolver support with customizable query strategies
- IPv4 and IPv6 support
- Web interface available at [doggo.mrkaran.dev](https://doggo.mrkaran.dev)
- Shell completions for `zsh` and `fish`
- Reverse DNS lookups
- Flexible query options including various DNS flags (AA, AD, CD, DO, etc.)
- Debug mode for troubleshooting
- Response time measurement
- Cross-platform support (Linux, macOS, Windows, FreeBSD, NetBSD)
19 changes: 9 additions & 10 deletions docs/src/content/docs/intro/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,21 +5,20 @@ description: Learn how to install Doggo, a modern command-line DNS client for hu

Doggo can be installed using various methods. Choose the one that best suits your needs and system configuration.

### Easy Install (Recommended)

### Binary Installation

You can download pre-compiled binaries for Linux, macOS, and Windows from the [Releases](https://github.com/mr-karan/doggo/releases) section of the GitHub repository.

To install the latest `linux-amd64` binary:
The easiest way to install Doggo is by using the installation script:

```shell
$ cd "$(mktemp -d)"
$ curl -sL "https://github.com/mr-karan/doggo/releases/download/v0.3.7/doggo_0.3.7_linux_amd64.tar.gz" | tar xz
$ mv doggo /usr/local/bin
# doggo should be available now in your $PATH
$ doggo
curl -sS https://raw.githubusercontent.com/mr-karan/doggo/main/install.sh | sh
```

This script will automatically download and install the latest version of Doggo for your system.

### Binary Installation

You can download pre-compiled binaries for various operating systems and architectures from the [Releases](https://github.com/mr-karan/doggo/releases) section of the GitHub repository.

### Docker

Doggo is available as a Docker image hosted on GitHub Container Registry (ghcr.io). It supports both x86 and ARM architectures.
Expand Down

0 comments on commit 9d9b9b1

Please sign in to comment.