Giter VIP home page Giter VIP logo

docs's Introduction

Logo

Dyte Docs

Dyte's documentation portal, built with Docusaurus.
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

About The Project

Docusaurus is a static site generator that helps you ship beautiful, accessible docs. For building our documentation portal, we have made certain modifications over the template generated by Docusaurus to be able to properly showcase all our SDKs with their respective versions.

We are delighted to see our documentation featured on Docusaurus Site Showcase, and hope you like it!

Built With

Getting Started

This section describes how you can get our documentation portal up and running on your machine.

Prerequisites

Installation

  1. Clone the repo
git clone https://github.com/dyte-io/docs.git
  1. Install NPM packages
npm install
  1. Run the app
npm start

Usage

Writing Documentation

To just edit older documentation, go to the specified versioned folder for a section, for example, you want to edit documentation for React SDK v0.25.x, open up react_versioned_docs/version-0.25.x and edit the required files there.

To create a new version inside a section, for example, flutter. Make your changes in docs/flutter. The ./docs folder consists of the next version, which is unpublished, and is where you add your newer or next version of documentation.

After your changes are done, to create a version, run the following command:

npm run docusaurus docs:version:flutter 1.2.3

This will create a new version 1.2.3 for flutter.

Reference: https://docusaurus.io/docs/versioning

To add new sections

Create a new section in docusaurus by adding a new plugin entry in docusaurus.config.js.

If you're adding a new section, just add new section to SECTIONS[] array with the defineSection() utility easily.

Now, run npm start and you can access your Go docs at http://localhost:3000/go/introduction

Then, you can create versions and edit older versions as mentioned above.

Adding new docs to the Context Switcher

To add a newly created section to the Sections Menu, edit ./src/sections.js.

For example, for a section go, you will add:

import { GoIcon } from '../assets/icons';

const SECTIONS = [
  // ...
  {
    id: 'go',
    name: 'Go',
    icon: GoIcon,
    section: false, // if it shouldn't have a sections menu
  },
];

You'll need to create a GoIcon component too.

That is it!

Version History

See CHANGELOG.

Roadmap

See the open issues for a list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated. Sincere thanks to all our contributors. Thank you, contributors!

You are requested to follow the contribution guidelines specified in CONTRIBUTING.md and code of conduct at CODE_OF_CONDUCT.md while contributing to the project 😄.

Support

Contributions, issues, and feature requests are welcome! Give a ⭐️ if you like this project!

License

Distributed under the Apache License, Version 2.0. See LICENSE for more information.

About

docs is created & maintained by Dyte, Inc. You can find us on Twitter - @dyte_io or write to us at dev [at] dyte.io.

The names and logos for Dyte are trademarks of Dyte, Inc.

We love open source software! See our other projects and our products.

docs's People

Contributors

akash-dyte avatar akshaybhalotia avatar archanas-dyte avatar ashishkumar4 avatar feniljain avatar harshtomar6 avatar irohitb avatar ishita1805 avatar kumarsudhir7891 avatar kushagra12 avatar madhugb avatar manyaagarwal avatar mayankofficial999 avatar mayur-tendulkar avatar palashgo avatar ramyak-mehra avatar ravindra-dyte avatar roerohan avatar rohitkhirid avatar saksham-gt avatar saurusxi avatar semantic-release-bot avatar shaunak-jagtap avatar sphericalkat avatar swapnilmadavi avatar thebongy avatar thisisamank avatar toxicitymax avatar vaibhavshn avatar yash-garg 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

docs's Issues

Security issue

Are you certain it's a bug?

  • Yes, it looks like a bug

Are you sure this is not an issue in Docusaurus?

  • It is not a Docusaurus issue

Is there an existing issue for this?

  • I have searched existing issues, it hasn't been reported yet

Issue description

@vaibhavshn check twitter DMs

Update openAPI spec automatically

Is there an existing issue for this?

  • I have searched existing issues, it hasn't been reported yet

Use case description

Currently there is an open API spec maintained in our backend repo but it's not the same shown to the clients. After the spec is merged to master, we have to manually update the spec file here.

Proposed solution (optional)

Either use the deployte bot or a GitHub action to detect when the spec is updated on the backend and create a PR here automatically.

In-app Documentation link is not working

Are you certain it's a bug?

  • Yes, it looks like a bug

Are you sure this is not an issue in Docusaurus?

  • It is not a Docusaurus issue

Is there an existing issue for this?

  • I have searched existing issues, it hasn't been reported yet

Issue description

The "Documentation" CTA link in the app dashboard is broken. It points to docs.dyte.in/docs and not redirecting to docs.dyte.io/docs/home/introduction

Screenshot 2022-06-14 at 5 14 24 PM

The active element in header is misconfigured

Are you certain it's a bug?

  • Yes, it looks like a bug

Are you sure this is not an issue in Docusaurus?

  • It is not a Docusaurus issue

Is there an existing issue for this?

  • I have searched existing issues, it hasn't been reported yet

Issue description

While we are at web sdk documentation the header has two selected element shown that are Web Sdk and Mobile Sdk both gets the class text-primary-100 so they looks like they are the active currently.
Screenshot-2022-06-23-151852.png

<div class="hidden space-x-6 text-text-100 lg:flex">
<a class="inline-flex items-center text-sm font-medium hover:no-underline text-text-100" href="/react/quickstart">
Prebuilt SDKs
<span class="pill pill-warning ml-2">
OLD
</span>
</a>
<a class="inline-flex items-center text-sm font-medium hover:no-underline text-primary-100" href="/react-ui-kit/installation">
Web SDKs
<span class="pill ml-2">NEW</span>
</a><a class="inline-flex items-center text-sm font-medium hover:no-underline text-primary-100" href="/react-native-core/installation">
Mobile SDKs
<span class="pill ml-2">
NEW
</span>
</a>
<a href="/api/" class="text-sm font-medium hover:no-underline text-text-100">
API Reference
</a>
<a class="text-sm font-medium hover:no-underline text-text-100" href="/guides/integrating-with-webhooks">
Guides
</a>
</div>

While selecting the mobile sdk documentation the class is not assigned to any of the header elements and it remains to text-text-100 for all the elements respectively.

Screenshot-2022-06-23-151907.png

<div class="hidden space-x-6 text-text-100 lg:flex"><a class="inline-flex items-center text-sm font-medium hover:no-underline text-text-100" href="/react/quickstart">
Prebuilt SDKs
<span class="pill pill-warning ml-2">OLD</span>
</a>
<a class="inline-flex items-center text-sm font-medium hover:no-underline text-text-100" href="/react-ui-kit/installation">
Web SDKs
<span class="pill ml-2">
NEW
</span>
</a>
<a class="inline-flex items-center text-sm font-medium hover:no-underline text-text-100" href="/react-native-core/installation">
Mobile SDKs
<span class="pill ml-2">
NEW
</span>
</a>
<a href="/api/" class="text-sm font-medium hover:no-underline text-text-100">
API Reference
</a>
<a class="text-sm font-medium hover:no-underline text-text-100" href="/guides/integrating-with-webhooks">
Guides
</a>
</div>

drop-down menu bug

Are you certain it's a bug?

  • Yes, it looks like a bug

Are you sure this is not an issue in Docusaurus?

  • It is not a Docusaurus issue

Is there an existing issue for this?

  • I have searched existing issues, it hasn't been reported yet

Issue description

image
When choose the 2nd or 3rd item, then click the menu, the selected item auto switched to 1st one.

API

Are you certain it's a bug?

  • Yes, it looks like a bug

Are you sure this is not an issue in Docusaurus?

  • It is not a Docusaurus issue

Is there an existing issue for this?

  • I have searched existing issues, it hasn't been reported yet

Issue description

Hello, I would like to provide feedback on an issue with interface debugging in a document. When I try to modify the request content in the body, there are some alignment issues with the styles.

image

[FIX] - Auto Collapsible Sidebar

Is there an existing issue for this?

  • I have searched existing issues, it hasn't been reported yet

Use case description

Use case Description
Overwhelming Navigation The vast array of categories shown in the sidebar may be too much for new website visitors to handle. It is preferable to have the sidebar open for the sole category in which the user is interested
Scrolling Fatigue If there are numerous categories in the sidebar, users may need to scroll extensively to find the specific category or content they are interested in, leading to scrolling fatigue.
Lack of Personalization Users may want to customize their navigation experience by collapsing or prioritizing certain categories, which is not possible with a fixed sidebar

Proposed solution (optional)

Modifying the Docusaurus configuration file (typically docusaurus.config.js) to enable the collapsible sidebar feature will help us in solving this issue. It can be achieved by adjusting settings related to the sidebar in the configuration.

Present Scenario Post Scenario (Proposed Solution)
Currently, when I click on the Build your own UI category, it expands to reveal its subcategories. However, if I then want to navigate to the Customizations category, and I click on it, the sidebar for the Build your own UI category remains open and doesn't collapse automatically. This can make it confusing to navigate the sidebar efficiently. In the improved scenario, when I click on the Build your own UI category, it will expand to reveal its subcategories just like before. However, if I then want to navigate to the Customizations category and click on it, the sidebar for the Build your own UI category will automatically collapse. This enhancement will make navigation more intuitive and efficient.

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.