Git Product home page Git Product logo

jwilferd10 / readmegenius Goto Github PK

View Code? Open in Web Editor NEW
3.0 1.0 15.0 19.57 MB

ReadMeGenius is a markdown generator that streamlines the creation process and assists in producing effective and professional-grade documentation, or a baseline for developers to work off of. ๐Ÿš€

License: MIT License

JavaScript 100.00%
inquirerjs javascript markdown markdown-generator nodejs readme-generator readme-template

readmegenius's Introduction

ReadMeGenius

Elevate Your Documentation Game

๐Ÿ“‚ Table of Contents

๐Ÿ‘‹ Description

๐Ÿ› ๏ธ Build Your Documentation

In the realm of software development, effective documentation is paramount. Enter ReadMeGenius, your trusted ally in project documentation. As a meticulously designed markdown file generator, ReadMeGenius empowers you to streamline the documentation process with ease. Elevate your project's professionalism and ensure comprehensive documentation with this invaluable tool. Here's an interesting tidbit, the baseline for this README was generated by this very project!

๐Ÿš€ Features

  • Guided README Creation: Easily create README files by answering guided questions.
  • Customizable Content: Tailor READMEs by choosing which sections to include.
  • Multiple Inputs: Add multiple inputs within a single section.
  • Ready-to-Use READMEs: Generate complete README files for immediate use.
  • Foundation for Customization: Build upon generated READMEs for further customization.

๐ŸŒ Open

ReadMeGenius is an open-source project built with the goal of making project documentation easier and more accessible to everyone. My commitment to openness means that this repository is open to the public, inviting exploration and encouraging creativity. Please feel free to delve into the codebase, generate markdown files, fork the project, and customize it to suit your specific needs.

๐Ÿ’ญ Developer Notes

  • ReadMeGenius' Inquirer package has been updated to use version ^9.2.8.
  • Asynchronous operations now utilize Async/Await expressions, moving away from promises.
  • Users now have the ability to add multiple inputs within each section.

The creation of ReadMeGenius was an educational journey. Throughout the development process, I used the opportunity to solidify my coding knowledge, building upon the concepts I had previously learned from a different project, PortfolioForge. Simultaneously, I used this experience to introduce new ideas and improve the content of this markdown generator.

For example:

  1. generateMarkdown.js utilizes regex and .replace() to remove extra spacing
  • data.replace(/^(?:\t| {2,})/gm, '')
  1. Using newly learned syntax to create a new line for each section/subsection
  • \n

In the future I'd like to create a more extensive version of ReadMeGenius that allows users to add more to their markdown files. Such as images, bullet points, and so on.

๐Ÿ™ Thank You!

So much for checking out ReadMeGenius, my intention is that it proves helpful to you in creating documentation for your own projects. Furthermore I hope the code base itself is able to help you out however possible. Please feel free to fork this repo, I hope you find ReadMeGenius a helpful addition to your development toolkit and happy coding!

๐Ÿ“– User Story

  • WHEN I am prompted for information about my application repository

    • THEN a high-quality, professional README.md is generated with the title of my project and sections entitled Description, Table of Contents, Installation, Usage, License, Contributing, Tests, and Questions
  • WHEN I enter my project title

    • THEN this is displayed as the title of the README
  • WHEN I enter a description, installation instructions, usage information, contribution guidelines, and test instructions

    • THEN this information is added to the sections of the README entitled Description, Installation, Usage, Contributing, and Tests
  • WHEN I choose a license for my application from a list of options

    • THEN a badge for that license is added near the top of the README and a notice is added to the section of the README entitled License that explains which license the application is covered under
  • WHEN I enter my GitHub username

    • THEN this is added to the section of the README entitled Questions, with a link to my GitHub profile
  • WHEN I enter my email address

    • THEN this is added to the section of the README entitled Questions, with instructions on how to reach me with additional questions
  • WHEN I click on the links in the Table of Contents

    • THEN I am taken to the corresponding section of the README

๐Ÿ’พ Resources Used

  • JavaScript
  • Node.js
  • NPM (Node Package Manager)
  • Inquirer (v. ^9.2.8)

๐Ÿ’ฝ Usage

To get started with ReadMeGenius, follow these steps:

  1. Navigate to the Main Directory: Open your terminal or command prompt and navigate to the main directory of the ReadMeGenius project.
  2. Run the Application: Type the following command and press Enter to run the application: node index
  3. Answer Guided Questions: You will guided through a series of questions to help you decide what sections and content you want to include in your README file. These questions cover various aspects of your project documentation.
  4. Provide Section Details: After answering the initial questions, you'll be prompted to provide specific details for each selected section of your README. Follow the prompts to enter your project's information, such as project title, description, user stories, resources used, and so on.
  5. Console Guidance: Helpful console messages are displayed throughout the process to assist you and ensure that you provide the necessary information.
  6. Completion Notification: Once you've finished providing all the required details, you'll receive a notification indicating the successful creation of your README file. In case of any errors or missing information, you'll be notified to address them.

Generating professional-grade README files for your projects becomes a straightforward and guided process with ReadMeGenius. Start using it today to streamline your project documentation efforts!

๐Ÿ“Ž Contributors

  • jwilferd10

๐Ÿ“ง Contact Information

readmegenius's People

Contributors

jwilferd10 avatar

Stargazers

 avatar  avatar  avatar

Watchers

 avatar

readmegenius's Issues

Update: Restructure Readme Template

When creating a Readme file, include:

  • Readme title
    • Readme subtitle (optional)
  • Table of Contents
  • Description
    • Sub-headers and subsequent text
  • Resources Used
  • Usage (Getting Started)
  • Contributors
  • Contact Information

Refactor Prompts

Ensure each prompt has:

  • Uniform capitalization and punctuation
  • Helpful logs

Refactor Markdown Generation

As updates continue, the generateItemMD functions will bloat the generateMarkdown.js file.

Idea:

  • Consolidate the generation process into one function
  • Pass the necessary data from the individual generateItemMD functions.

Badges Not Working On Some Licenses

As title says, beyond MIT and Apache the other license badge will not work.

  • Possibly add custom badges to user choices instead.
    OR
  • Condense name of license choices to one word.

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.