Hello Alexey, Thursday, November 12, 2015, 12:21:29 AM, you wrote:
> Hi Paul, >> My concern is that publishing (and publicizing) beta docs will lead to >> them being widely distributed and many people will use them for >> reference instead of for reviewing. > Yes, it could be. To solve it, we can organize it through subscription > to some close list, where we will be able to send notifications of > updates, and also we'll BIG notice about beta stage in the beginning, > suggesting to get new version, with URL where update is located. > I can create such list and provide all infrastructure - signup forms, > automatic subscriptions and unsubscriptions, etc. >> >> An alternative might be to invite knowledgeable Firebird users as beta >> reviewers and provide them with the material. (We could approach certain >> people directly and/or post a message in e.g. fb-general explaining what >> is needed and asking people to step forward if they feel they can help >> with this.) > Yes, this is a good idea. >> >> That being said, I think this should be Helen's call, because the burden >> of weeding through all the feedback will be largely on her. > There always will be mistakes and some unclear things. Indeed. The reviewers we have at present - PaulV and Mark Rotteveel - are both excellent at finding these. As you may have noticed yourself, there have been many. There is still a lot of ground to cover. Paul is part-way through the DDL chapter. Mark started at the other end and came up as far as Security. What we have left to do now, is the remainder of the DDL, the whole of DML, the whole of Functions & Variables and the whole of PSQL. We are not even CLOSE to any kind of "public beta" and it would help things along to find reviewers capable and willing to tackle some of these parts. The idea of a closed list is a good one, provided we can find more reviewers. Otherwise, the status quo would suffice. We need reviewers who are fluent in English AND SQL. I am more than happy to coordinate so we can avoid covering territory that has already been covered. Helen ------------------------------------------------------------------------------ _______________________________________________ Firebird-docs mailing list Firebird-docs@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/firebird-docs
