Comments (17)
Great, thank you for the explanations! I'm gonna probably use Rmarkdown and knit from this. I haven't done any pull requests before, but I'm keen to try. Ok, I'll see how far I can get before I'm stuck ;)
from blog.
Hi, I have some days to write the post - could you give me some instructions on what to use and where to submit it?
from blog.
Yay!
Do you think you'll write in Markdwon directly or do you want to knit from R Markdown?
from blog.
I've opened a draft PR so you might see how the PR will look like. Post preview. You're the first guest post writer so I apologize in advance for any problem and I welcome any question/feedback!
-
You can write the post in a separate project and folder using the template. It should be named index.Rmd. Knitting it will produce both index.md, and index.html that will be ignored in your PR later. At the end of this step you'll have a folder with index.Rmd, index.md, images, (and index.html). You can also directly use the index.md template as you prefer.
-
Then you can clone this repo, and create a branch from master. Insert the folder from the previous step under post/, with a name that's YYYY-MM-DD-slug. Push and open a pull request.
-
I'll make comments and edit suggestions in the PR. We can edit the publication date based on progress, no pressure.
As you see we don't have author pages yet hence my template's encouraging your adding info at the beginning and at the end of the post for readers to easily connect with you. You can replace "Julia" with "Dr Julia Romanowska", I've just written Julia, no first name obligation obviously.
Thank you! I'm looking forward to reading your post!
from blog.
I forgot to add that if you're not at ease with the PR making, I can help with that!
from blog.
And reg content, here are a few possible questions
- What does your package do? (briefly, with a link to its homepage and/or source code repo)
- How/when did you notice the CRAN problem? (btw we have two relevant posts on the blog, How to handle CRAN checks with help from R-hub and Overview of the CRAN checks API).
- How did you reproduce the CRAN error? What problems did you encounter?
- How did you solve the CRAN error? Has the package been updated on CRAN or is it in progress?
- What resources would you recommend/what lessons have you learnt?
from blog.
Cool!
When you're at the PR stage of course I'll help but you might also find this vignette and the related tools helpful.
from blog.
* Insert the folder from the previous step under post/, with a name that's YYYY-MM-DD-slug.
Did you mean to insert it under "content"? I can't see a "post" folder in the main folder.
from blog.
Right, sorry, yes, content/post/ as in the PR.
from blog.
Hi and Happy New Year!
I've tried pushing my new branch to github repo, but I don't seem to have access to push changes... is this true? Or am I doing something wrong?
> home:post$ git push --set-upstream origin jromanowska-guest-post
ERROR: Permission to r-hub/blog.git denied to jromanowska.
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.
from blog.
Hi, happy new year! Yes, you need to fork the repo first and create the branch in the fork, sorry for being unclear. I'd recommend first making a copy of your local folder to not lose your work.
from blog.
Ok, now I think I've managed to do that. Sorry - it's my first time contributing to somebody else's repo! :)
from blog.
No problem at all!
from blog.
fixed in #46
from blog.
Hi again :)
@HenrikBengtsson gave me some tips regarding the blog post and I would like to update it - should I just add some text at the bottom or re-write the post?
from blog.
@jromanowska you can update the post (make a PR editing it), depending on the number of edits you can add a note in italic at the beginning "edited on thanks to comments by Henrik Bengtsson". This way future readers only see the updated version?
from blog.
Yes, great!
from blog.
Related Issues (20)
- Optimal workflows for package vignettes - R-hub blog HOT 10
- QC.R and check.R
- testthat utility belts HOT 9
- Everything centered on small screens, e.g. mobile HOT 1
- cran etiquette HOT 1
- Helper code and files for your testthat tests - R-hub blog HOT 9
- What is OAuth2.0 HOT 2
- backports and other approaches HOT 6
- the story of roxygen2? HOT 2
- onLoad(), package internal environment etc. HOT 2
- How to use r-hub docker containers in GitHub actions HOT 5
- Caching the results of functions of your R package - R-hub blog HOT 2
- Tools for input checking in functions HOT 7
- Post about ellipsis HOT 3
- How to deal with OAuth2.0 in R packages? - R-hub blog HOT 3
- Checking the inputs of your R functions - R-hub blog HOT 1
- No line break between code and code output HOT 1
- Minimum R version dependency in R packages - R-hub blog HOT 4
- Objects that feel mutable in R - R-hub blog HOT 3
- A testing pattern: adding switches to your code - R-hub blog HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
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.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from blog.