[cctbxbb] CCTBX documentation questionnaire

[Dorothee Liebschner]

Hi Graeme,

People at the forum mostly raised the issue of documentation, and the aim
of my questionnaire is to find out starting points to improve it.
You could make a different topic for installation issues; or your own
questionnaire. Disturbing this thread is counterproductive.

Cheers,

Dorothee

On Fri, Aug 16, 2019 at 2:30 AM Graeme.Winter at Diamond.ac.uk <
Graeme.Winter at diamond.ac.uk> wrote:

> Hi Dorothee
>
> I suspect that the document lack is a big chunk, but the fact that you
> cannot easily add cctbx to your standard python installation via say pip is
> perhaps a bigger impediment
>
> Telling people they can pip install makes for a low barrier
>
> Telling them they have to chuck their existing set up and use special
> different python is a high one
>
> And I keep getting told this at diamond!
>
> Does not mean we should ignore document improvement, as that is much
> needed too
>
> Best wishes Graeme
>
> On 15 Aug 2019, at 20:05, Dorothee Liebschner <dcliebschner at lbl.gov
> <mailto:dcliebschner at lbl.gov>> wrote:
>
> Hi everyone,
>
> During this year's ECM computing school, it came up that the CCTBX does
> not have a lot of documentation. This seems to be a major reason why people
> don't use it, even if they would like to employ the libraries.
> We would like to find out which parts of the CCTBX are the most
> interesting for users. We certainly cannot provide extensive documentation
> for the entire toolbox, but we can see what we can do once we know the main
> areas of interest.
> So if you were in the situation of wanting to use the CCTBX but decided to
> stay away from it because the documentation was non-existent or obscure,
> please let us know by filling out the questionnaire below (it's anonymous):
>
> questionnaire CCTBX documentation<https://forms.gle/9RawJFfHyEvhCVVP7>
>
> Best wishes,
>
> Dorothee
>
> --
> Project Scientist, Molecular Biophysics and Integrated Bioimaging
> Lawrence Berkeley National Laboratory
> 1 Cyclotron Road, M/S 33R0345
> Berkeley, CA 94720
> Tel: (510) 486-5709
> Fax: (510) 486-5909
> Web: https://phenix-online.org<https://phenix-online.org/>
> _______________________________________________
> cctbxbb mailing list
> cctbxbb at phenix-online.org<mailto:cctbxbb at phenix-online.org>
> http://phenix-online.org/mailman/listinfo/cctbxbb
>
> --
> This e-mail and any attachments may contain confidential, copyright and or
> privileged material, and are for the use of the intended addressee only. If
> you are not the intended addressee or an authorised recipient of the
> addressee please notify us of receipt by returning the e-mail and do not
> use, copy, retain, distribute or disclose the information in or attached to
> the e-mail.
> Any opinions expressed within this e-mail are those of the individual and
> not necessarily of Diamond Light Source Ltd.
> Diamond Light Source Ltd. cannot guarantee that this e-mail or any
> attachments are free from viruses and we cannot accept liability for any
> damage which you may sustain as a result of software viruses which may be
> transmitted in or with the message.
> Diamond Light Source Limited (company no. 4375679). Registered in England
> and Wales with its registered office at Diamond House, Harwell Science and
> Innovation Campus, Didcot, Oxfordshire, OX11 0DE, United Kingdom
>
> _______________________________________________
> cctbxbb mailing list
> cctbxbb at phenix-online.org
> http://phenix-online.org/mailman/listinfo/cctbxbb
>


-- 
Project Scientist, Molecular Biophysics and Integrated Bioimaging
Lawrence Berkeley National Laboratory
1 Cyclotron Road, M/S 33R0345
Berkeley, CA 94720
Tel: (510) 486-5709
Fax: (510) 486-5909
Web: https://phenix-online.org
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://phenix-online.org/pipermail/cctbxbb/attachments/20190816/cdb9c2f0/attachment.htm>