Giter VIP home page Giter VIP logo

Comments (5)

RjLi13 avatar RjLi13 commented on July 19, 2024

Hey rnobleeddy, I think I'd like to take a stab at this if it is still an issue that should be solved. Based on your suggestion, should we get rid of the vignette and put the information on the README instead? Or extract parts of the vignette such as a more detailed summary and the functions available to the user?

from datacomparer.

robne1982 avatar robne1982 commented on July 19, 2024

Again, apologies for the slow reply.

I think the vignette is probably OK, but we should add a little of the content to the README. For example, the top of https://github.com/tidyverse/dplyr/blob/master/README.md has the main info about what the package does. I'm not entirely sure how we'd do this for this package, but it's probably a better advertisement if there's a little more about how the package works at the top of the README.

Let me know own if you disagree?

from datacomparer.

RjLi13 avatar RjLi13 commented on July 19, 2024

Perhaps we can add the functions that are exposed for the end user to use along with a short description, much like the link you sent? For the content of the top of the README, we could copy the top of vignette. Then, replace the top of the vignette with a 1-2 sentence blurb introducing an example workflow.

The vignette intro feels to be at the wrong place because the user would know what the project is about already through the README. It fits better as the top of the README. I can present a pull request of a changed README/vignette if this is agreeable?

from datacomparer.

RjLi13 avatar RjLi13 commented on July 19, 2024

Also, I am facing an issue with the second install option with devtools and install_git. This seems to be a Mac issue currently broken as shown here. If this isn't merely my own environment issue, I'd like to also add a note warning Mac users that the second install option currently does not work.

from datacomparer.

RjLi13 avatar RjLi13 commented on July 19, 2024

I took the opportunity to change both the README and the vignette. If you could take a look and see if something like this fits the bill?

from datacomparer.

Related Issues (20)

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.