Giter Club home page Giter Club logo

readme.so's Introduction

readme.so

Readme.so is an online editor to help developers make readmes for their project.

Link to production site: readme.so

Features

  • Choose from list of sections to add to your readme
  • Edit the contents of each section
  • Drag and drop to rearrange sections
  • Download your readme file

Contributing

Contributions are always welcome!

See CONTRIBUTING.md for ways to get started.

Tech Stack

Running the Dev Server

To run the dev server, run npm run dev and navigate to localhost:3000

Feedback

Feedback is appreciated! Reach out on Twitter or submit a new issue!

License

MIT

This readme was created with readme.so :)

readme.so's People

Contributors

abdullahceylan avatar allancolibao avatar fatmakiraz avatar gilvan-araujo avatar imadatyatalah avatar jmolina518 avatar jose-vale avatar katherineoelsner avatar kdpuvvadi avatar max-programming avatar micahbcode avatar nachoiacovino avatar natterstefan avatar noelsner avatar octokatherine avatar orama254 avatar pbek avatar pedrozebra avatar ricardobr001 avatar rishabhrathod01 avatar roccosangellino avatar rohitjmathew avatar saurabhchaturvedy avatar shookcodes avatar strangernr7 avatar sumitnalavade avatar ulugbekmuslitdinov avatar vishnumohanrk avatar waldyrious avatar yipei1028 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  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

readme.so's Issues

Local storage implementation to save app state on page refresh

@katherinepeterson , as discussed previously , to work on "clearAll" functionality and other things , local storage should be in place . It's even relevant and meaningful to implement before we implement the "adding a new custom section" functionality . I'll take this up.

Allow importing an existing readme

-user can upload an existing readme and edit

  • ideally we would parse the headers and create custom sections for what they already have

Suggested change : "Authors" and "Acknowledgement" should be separate sections

@katherinepeterson , i think its better to keep authors and acknowledgement sections as separate , as they kinda serve a bit different purpose , also one unassumed benefit would be that the section name also would not be unnecessary too long which might also avoid bloating UI alignment in future .

My understanding on purpose of sections :
Authors -- can be used mention the key authors of the codebase/project
Acknowledgements - also mean crediting other libs , projects , of which help/inspiration was taken to build a project . One such example here : https://github.com/othneildrew/Best-README-Template

Design bug: The body is bigger than the actual screen

This might just be a personal preference, but the whole body overflows and a scrolling bar is seen:
image

And since the left side menu is already a scrolling one, I don't think the whole body should scroll too.
I see the three elements have max-h-screen to be as tall as the screen, but since there is a header on the top, and some text as well, the overflowing happens.

Make site responsive for mobile

Currently, on any touch devices, when you navigate to the editor it just shows a message saying that this site is optimized for desktop.

Keyboard navigation skips translation URLs

Navigating the website with Tab key skips the translation links in <LanguageDropDown />.

display: none is skipped from Tab cycle. So, we could use scale or opacity, along with group-hover: and focus-within:. These properties can also be animated, so we could add a transition.

Mac emoji shortcut support

Feedback from Twitter:

the text areas won't accept the (crtl + cmd + space) mac shortcut for bringing the emojis menu

Tab and Undo (ctrl z) support in editor

Feedback from Twitter:

— while using editor i selected multiple lines and pressed TAB key ( for indentation ) those lines got erased.
— then i tried undoing ( cmd + z ) but editor didn't had undo support for that change.

Embed Product Hunt badge on landing page

Code to embed:

<a href="https://www.producthunt.com/posts/readme-so?utm_source=badge-featured&utm_medium=badge&utm_souce=badge-readme-so" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=291731&theme=light" alt="readme.so - Easily create the perfect readme for your project | Product Hunt" style="width: 250px; height: 54px;" width="250" height="54" /></a>

Language definitions localization advice

Each language should be written in their original/ local language in every language pages of the website. If I am in the website which is Spanish as a Turkish person, I should see "Türkçe" word as an option in the language dropdown not "Turco" which is called by Spanish people. Because I may not be able to know the definition of "Türkçe" in Spanish. So here is my advices below:
Every languages should be the same in all language pages.
English,
Français,
Español,
Italiano,
Türkçe

If you agree with me I can fix it.

Installing or Updating NEXT

If the end user does not have nextjs installed before running the project:

npm install next or npm update next <--- Most likely, you should just be able to instead of installing as it should already be installed.

Then

run npm run dev and you should be set to go with the following messege ready - started server on 0.0.0.0:3000, url: http://localhost:3000. You can also just hold ctrl+left click the url: http://localhost:3000 which will open up in a tab in your browser.

Full View of Editor

As a user, I should be able to view the full readme at once in the editor pane if I want to instead of just separate sections.

I suppose we can have one more item in the section tab named Full View (or something else, I am not good with naming :p) which would preview the whole readme in the Editor pane.

I am not entirely sure how big of a task this would be or will need how the data is managed entirely but it feels like this should be possible and might increase user experience for the people who like having a full view before they download their hours of work creating an awesome readme 😉

Suggested Feature : Add emoji Support

Hey @katherinepeterson , pretty trivial feature but I think it will be nice to support adding markdown emojis within the app as I've noticed that quite a number of READMEs have them (including some of mine haha). Let me know what you think, thank you.

"Clear All" kind of functionality to clean up the added readme sections to start fresh

Currently , when a user wants to reset its readme file's content (i.e start from scratch with just the 'title and description' template) , he/she has to refresh the entire page in chrome/any browser . Currently we can delete individual sections by clicking on delete icon one by one , but can't delete all at one . So , should we support a "clear all" to clean up all sections at once or let us just browser refresh do it for now ? Also , is the browser refresh supposed to clean-up all the used sections while a user is creating a readme , and in middle of it the progress is lost if he just refreshes the browser (if he didn't backed up the document by downloading in-between) ? While working with swagger editor online for designing APIs i have experienced , it saves the state for the current session of user from local storage with any custom changes , even if he refreshes browser as here : https://editor.swagger.io/ .

image

[FEATURE] Dropdowns Section

For example:

What is my problem?
I don't know LOL
  • One
  • Two

How can you do this? 👆

<details>
<summary>What is my problem?</summary>
<br> I don't know LOL </br>
<ul>
     <li>One</li>
     <li>Two</li>
</ul>
</details>

Source: Dropdowns Gist
Thank You, @citrusui! 🤩

UI heading : suggested alignment for consistency.

@katherinepeterson after having look at raw-markdown-preview-feature added by @jmolina518 , i just had a thought for a small UI change , if we could align the headings to match with the smaller font & liked the color scheme used by @jmolina518 , it's looking sleek & smart than bigger headings as of now .

Current editor UI :
image

Suggested Change

image

Turkish Typo Fixes

Turkish language ISO code is "TR" not "TUR". Also there are some typo mistakes in Turkish translation.

Add light/dark theme toggle to editor

The Editor component takes a string for a theme. It currently is set to "vs-dark"

  • add a dark mode toggle button that toggles the editor theme between "vs-dark" and "vs"

Removing a section from my readme banishes it forever

I should be able to re-add a section that I've removed. At the moment, if I add a section, then remove it, there's no way to re-add it.

For instance, I want to see what is in each section. I click on each one in turn, which adds it to the list. I don't want to add it right now, so I delete it. Now I can't find it again.

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.