Re: Newcomers page

2016-03-15 Thread Pedro Giffuni

Hello guys;

On 03/15/16 11:23, hiren panchasara wrote:

+ pfg to see if he has any inputs as he works actively with newcomers.

On 03/14/16 at 11:31P, hiren panchasara wrote:

I see many kids (specially during GSoC time) come to hackers and ask:
"I am very enthusiastic and know C/C++, xyz and completely new to FreeBSD
but want to contribute. Where do I start? What should I do?"

Is there a page which can provide answer to this question so we can
point them to the page?

I found
https://www.freebsd.org/projects/newbies.html

It'd be nice if we could add:
0) -questions and -hackers maling-lists as starting point for help.
1) list of ircs that we hangout in on EFNet: bsddev, bsdmips,
freebsd-gsoc, freebsd-git
2) bugzilla and how to search for interested keywords or bugs with patches
3) Ideas wiki page

Just my 2c.




I think the webpages are pretty good. The issue, as for the GSoC, is 
that we are not being very effective about taking students by the hand

and guiding them into considering a FreeBSD project.

One issue is the visibility of the pages: we guide people into the 
Projects ideas Wiki, but we have no idea if these people know what 
FreeBSD is or how to make their background match what they should

be looking at doing.

The second issue is that most projects are too difficult for people
that have no experience with a a unix-like OS or even just linux.

It's probably too late to fix this for this GSoC but we need to
sort this out.

Pedro.
___
freebsd-doc@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"


Where did we lurn to spel?

2016-04-28 Thread Pedro Giffuni

Hello;

I just updated locally the textproc/codespell to the latest version
(bugzilla 209128 for the curious), and it finds a *crazy* amount of
issues in code comments.

I can't handle it on my own, indeed I got tired just be checking
sys/arm ! Anyways, here is what I went "thru":

https://people.freebsd.org/~pfg/patches/codespell/

Enjoy,

Pedro.
___
freebsd-doc@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"


Re: Where did we lurn to spel?

2016-04-28 Thread Pedro Giffuni



On 04/28/16 16:36, Warren Block wrote:

On Thu, 28 Apr 2016, Warren Block wrote:


On Thu, 28 Apr 2016, Pedro Giffuni wrote:


Hello;

I just updated locally the textproc/codespell to the latest version
(bugzilla 209128 for the curious), and it finds a *crazy* amount of
issues in code comments.

I can't handle it on my own, indeed I got tired just be checking
sys/arm ! Anyways, here is what I went "thru":

https://people.freebsd.org/~pfg/patches/codespell/


textproc/igor finds many mistakes, and works on text files, man pages,
DocBook, and HTML.  Use of either of these tools is optional, though.

Note: in sys/arm/at91/if_atereg.h, it missed "deines"->"defines".




Yes, I haven't really reviewed them beyond the initial replacement.
The changes kept growing and growing and I had to stop.


Oh, and many of these are contractions, which should be avoided anyway.


Well the main questions are ...

1) Should someone brave just go ahead and commit massively
such cleanups?

2) Is there a clever review process to go through these?
Phabricator with documentation team, or assume common
sense?

3) There are many common issues: is "thru" something we should
accept in comments. How about dont vs don't ?

Pedro.
___
freebsd-doc@freebsd.org mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"