On 29/04/2012, at 5:19 PM, srean wrote:

> Hi John,

Hi!
> 
>  I have been using http://felix-lang.org:8080 and loved the
> documentation and tutorials there. I think it was more detailed than
> the one on the website, or may be I was seeing things. Overall it
> seemed nicer to the eye and more welcoming. It seems that content has
> been taken down, would you mind putting it up there back again.

The tutorial code, etc, that is part of the main website was taken
out of the Wiki because it was a copy, and therefore couldn't
be maintained...

Which leaves the Wiki with nothing in it. We still have an issue
with managing the content. The main website is part of the
git repository. The Wiki content isn't backed up at all, at the moment.

Also the main tutorial code shouldn't be edited directly through
the WIki even if it were put there, because the next pull from
the repository would clobber all the changes.

> I check on the googlegroups from time to time though I am not
> subscribed yet.

There's an Facebook group too if that suits, for chatter.

> In fact that is how I came to know of the link
> http://felix-lang.org:8080 before it was publicly linked to. One thing
> that I am curious about is that I often find you responding to a mail
> that apparently has no copy on the googlegroups archive.

Sometimes .. like right now .. someone emails me directly.
I often CC the reply to the lists so the the respondent gets
a convenient copy of the link, and because the content
could be usefully archived.

I'm sure Mike Maul (who developed the WIki) would be
interested in your comments.

The Wiki uses a copy of the formatting code that is used for
the main web-server (colourising content), except for fdoc
(Felix doc) files, where it actually uses an extension!

So the WIki is sill "experimental"  and we need to ensure it is
using the *same* code. 

Actually, the Wiki is an offshoot of Mike's webserver.
So Felix actually has TWO webservers. The main website
is using mine, which is a *personal web server*. It's an
"execute and go" webserver mainly for browsing your own
disk files (including any C, C++, Felix you have with 
inclusions hyperlinked).

Mike's is billed as an enterprise level webserver, that is,
one that is used by a corporation on its intra-net. As such,
it can require more configuration and management 
(which would not be tenable for a personal webserver).

BTW: I actually find the WIki formatting slightly bare and the
font colour a little too "easy" on the eye. I like the simplicity.
However you should note the main server does some nice
stuff like tooltips on hovering over certain words in Felix code.

> Is there
> another list on which the mails are sent,

Yes, there's a sourceforge based list as well.  That's still there
because there are a couple of lurkers that refuse to use Google.
I respect that. However the Google one is the primary one.

> Often times they are more informative and up to date
> than the official documentation, though it requires more digging.


Indeed, the documentation has nowhere near the information
in it that the emails have at the time of writing. I've been trying
to get the docs up to date and complete, but it is hard.

you can change the Felix grammar to add a new feature
in a couple of minutes. It would probably take a lot more
time to document the impact. Similarly, with programming tools
major library refactoring can be done more quickly than changing
the documentation. Validating the documentation examples also
takes time.

I'm looking for a way to synchronise documentation with the
Felix library code (including the grammar): I'm a Literate Programming
geek but most people don't like it, so we need a better way: some
kind of comments or something, and a way to skip details in
the docs that are needed in the library code ..

the other thing lacking is .. developers. A major language development
requires 20-30 people, presently we have 2-3.

As we're right now just getting the Windows build working, that may attract
some more developers.

BTW: in my philosophy at this stage: user = developer.

--
john skaller
skal...@users.sourceforge.net
http://felix-lang.org




------------------------------------------------------------------------------
Live Security Virtual Conference
Exclusive live event will cover all the ways today's security and 
threat landscape has changed and how IT managers can respond. Discussions 
will include endpoint security, mobile security and the latest in malware 
threats. http://www.accelacomm.com/jaw/sfrnl04242012/114/50122263/
_______________________________________________
Felix-language mailing list
Felix-language@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/felix-language

Reply via email to