Skip to content
This repository has been archived by the owner on Sep 1, 2020. It is now read-only.

first pass at adding docstrings #98

Merged
merged 3 commits into from
Apr 14, 2017
Merged

first pass at adding docstrings #98

merged 3 commits into from
Apr 14, 2017

Conversation

cormullion
Copy link
Contributor

I had a go at adding docstrings to src/Iterators.jl, since it's always nice to have some syntax info on hand. I also added a docs/ directory, which can be used as you migrate to using Documenter.jl (although the entire process is more involved, with the gh-pages branch and Travis keys stuff...

Logo.png is just a placeholder...

@codecov-io
Copy link

codecov-io commented Feb 11, 2017

Codecov Report

Merging #98 into master will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master      #98   +/-   ##
=======================================
  Coverage   94.11%   94.11%           
=======================================
  Files           1        1           
  Lines         374      374           
=======================================
  Hits          352      352           
  Misses         22       22
Impacted Files Coverage Δ
src/Iterators.jl 94.11% <ø> (ø)

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update b332f56...2886940. Read the comment docs.

@ararslan
Copy link
Member

It would be best to propose the logo change at JuliaCollections/Roadmap#2 to get feedback first.

@cormullion
Copy link
Contributor Author

@ararslan oh it's just a placeholder, they can chuck it away and run a competition if they want to!

@ararslan
Copy link
Member

I still recommend posting it at the roadmap issue so it's more visible. It just might become the org logo. 😉

Copy link
Collaborator

@iamed2 iamed2 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wow, thanks!

A few things:

  • The build directory is generated by Documenter when running make.jl so it shouldn't be committed here
  • Indentation in make.jl needs a fixup
  • You have an extra blank line at the end of all your code blocks that can be removed

Otherwise great!

@cormullion
Copy link
Contributor Author

@iamed2 Cool. I had left the docs/build/ in for testing, sorry, it's added to .gitignore now. I've also done some formatting.

(@ararslan I was thinking "iterators", not "collections". I'll have to ponder anew tomorrow...)

@ararslan
Copy link
Member

docs/build is added to the gitignore but it still has to be unstaged from the commit. You can do that using git rm if I'm not mistaken.

@cormullion
Copy link
Contributor Author

@ararslan thanks! I'm not a git-person... 😀

# Index

```@index
```
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Did you mean for this to be empty?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think if it's empty it defaults to doing everything...

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Oh, okay. I'm not so good with Documenter, I just wanted to make sure. 🙂

@cormullion
Copy link
Contributor Author

Needs the new logo... :)

@iamed2
Copy link
Collaborator

iamed2 commented Apr 14, 2017

The source branch was removed but this is still mergeable. I'll replace the logo myself and do a manual command-line merge. Hopefully I don't mess things up!

@iamed2
Copy link
Collaborator

iamed2 commented Apr 14, 2017

Hmm apparently that is not possible. I'll try merging using the online interface and modifying the logo after.

@iamed2 iamed2 merged commit c5e202d into JuliaCollections:master Apr 14, 2017
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants