Add docstrings for push, pop, pushfirst, popfirst, insert, deleteat

[garrison]

Also tested the new docstrings locally

The main "critique" I could make is that putting -> vec may imply the original vec is returned rather than a modified one. Suggestions welcome for making this more clear.

[garrison]

Also, I purposely left out setindex because it should really be documented in Base. However, I just realized that there is actually a slight difference between how setindex behaves here and in Base: in Base (for a Tuple) it will be a no-op if the last index is out of bounds, while here (for a StaticVector) it will throw a BoundsError. So maybe they actually each need a docstring after all.

[coveralls]

Coverage remained the same at 81.681% when pulling b2e7de2 on garrison:jrg/docstrings into be5ae30 on JuliaArrays:master.

[c42f]

Excellent, thanks! It seems that Base.setindex is not documented nor exported, so I think it would be worth documenting the setindex that we have here.

Regarding -> vec and making it clear that the input vec isn't modified, I suppose you could reword the text slightly. Eg for push:

Return a new vector with item inserted on the end of vec

and similarly for the others.

[garrison]

Changes made as requested. Please let me know if any other comments.

[fredrikekre]

putting -> vec may imply the original vec is returned rather than a modified one.

I suggest just dropping that.

[garrison]

Done

[c42f]

Looks great to me, thanks!