EcoClimLab / growth_phenology

Cameron Dow's growth phenology project
Creative Commons Attribution 4.0 International
1 stars 2 forks source link

editorial comments #137

Closed teixeirak closed 2 years ago

teixeirak commented 2 years ago

I believe the specific comments here are all we really need to pay attention to-- general point there just for reference.

Some specific comments:

More general points:

LENGTH: The length for the summary paragraph and body text should not exceed 2500-3000 words, and up to 4 ‘modest’ display items; a modest display item is one that, with its legend, occupies about a quarter of a page (equivalent to ~270 words). If a composite figure (with several panels) needs to occupy at least half a page in order for all elements to be visible, the text length may need to be reduced accordingly to accommodate such figures. Essential but technical details can be moved into the Methods or Supplementary Information (see below).

TITLE: Titles cannot exceed 75 characters (including spaces); they must not contain punctuation.

SUMMARY PARAGRAPH: Papers start with a fully referenced, bold paragraph, ideally of about 200 words, aimed at readers in other disciplines. Numbers, abbreviations, acronyms or measurements should be avoided unless essential. The summary paragraph consists of 2 to 3 sentences of basic-level introduction to the field; a brief account of the background and rationale of the work; a statement of the main conclusions (introduced by the phrase 'Here we show' or its equivalent); and a conclusion of 2 to 3 sentences putting the main findings into general context so it is clear how the results described in the paper have moved the field forward. A downloadable, annotated example is available at https://www.nature.com/nature/for-authors/formatting-guide.

MAIN TEXT: If further introductory material is necessary, the main text can begin with up to 500 words of introduction expanding on the background to the work (some overlap with the summary is acceptable), before proceeding to a concise, focused account of the findings, and ending with 1 or 2 short paragraphs of discussion. Sections are separated with subheadings (up to 40 characters including spaces) to aid navigation.

REFERENCES: As a guideline, most papers should include no more than 50 main text references; all additional references can be cited in (and listed after) the Methods section, as detailed below.

FIGURE LEGENDS: These should be listed sequentially after the main text references and not in the figure files. Each legend should begin with a brief title for the whole figure and continue with a short description of each panel and the symbols used. Legends should not exceed 300 words each. Each figure legend should contain, for each panel where relevant, the following information:

METHODS: The Methods section, which provides the full, step-by-step instructions that would allow other researchers to replicate the results, is included after the main text figure legends. The Methods section will not appear in print but will appear online in the full-text HTML and PDF versions. The Methods section should be written as concisely as possible but should contain all elements necessary to allow interpretation and reproduction of the results. If there are additional references (in the Methods section, Supplementary Information, etc), their numbering should continue from the last entry in the main text reference list, and they should be listed following the Methods section. Specialized methods that require chemical structures, figures or tables, or methods requiring equations, cannot be accommodated in the Methods section of the main text file. If such information is part of the Methods, the entire Methods section must instead be included within a Supplementary Information text file.

MAIN TEXT STATEMENTS: Several statements (which will not appear in print but will appear online in the full-text HTML and PDF) are required after the Methods (and additional references, if present). First, there should be an Acknowledgements section, listing grant/financial support. Next, we require a detailed Author Contribution statement; the specific contributions of each author, particularly in terms of which authors performed which specific experiments, must be listed. This is followed by a Competing Interest statement. Financial and non-financial interests should be noted here, as well as any patents; patent information should include at a minimum what is covered by the patent and who submitted the patent application. Finally, an Additional Information statement should include information regarding reprints and permissions and name the author(s) to whom correspondence and requests for materials should be addressed. For formatting details and an example see https://www.nature.com/nature/for-authors/formatting-guide.

DATA AND CODE AVAILABILITY STATEMENTS: All published manuscripts reporting original research in Nature Portfolio journals must include a data availability statement. The data availability statement must make the conditions of access to the “minimum dataset” that are necessary to interpret, verify and extend the research in the article, transparent to readers. This minimum dataset may be provided through deposition in public community/discipline-specific repositories, custom proprietary repositories for certain types of datasets, or general repositories like Figshare, Zenodo and Dryad. Providing large datasets in supplementary information is strongly discouraged and the preferred approach is to make data available in repositories. More information on Nature Portfolio’s reporting standards and preparing your Data Availability Statement can be found here: https://www.nature.com/nature-portfolio/editorial-policies/reporting-standards#reporting-requirements

For all studies using custom code or mathematical algorithm that is deemed central to the conclusions, a statement must be included under the heading "Code availability", indicating whether and how the code or algorithm can be accessed, including any restrictions to access. Code availability statements should be provided as a separate section after the data availability statement but before the References. Code should be deposited in a DOI-minting repository such as Zenodo, Gigantum or Code Ocean and cited in the reference list. Authors are encouraged to manage subsequent code versions and to use a license approved by the open source initiative. Additional details can be found here: https://www.nature.com/nature-research/editorial-policies/reporting-standards#availability-of-computer-code.

DISPLAY ITEMS: We suggest that you take stock of all data that have been generated throughout the review process and ensure that only the data most central to the conclusions are presented in the main text figures. Any figures included within the main text file during the review process must be removed from the final main text file and uploaded as separate, individual files; they will be integrated into the main paper in print and online. An overview of the key features of this presentation may be found at http://s3-service-broker-live-19ea8b98-4d41-4cb4-be4c-d68f4963b7dd.s3.amazonaws.com/uploads/ckeditor/attachments/7824/3g_Paper_composition.pdf.

Figures should be comprehensible to readers in other disciplines and assist in understanding of the paper. Main text figures (but not Extended Data) must be provided in production-quality versions in an editable format (i.e., .ai, .cmx, .cdr, .doc, .eps, .pdf, .ppt, .ps, .psd, .svg and .xls); we cannot accept figures in .cvs, .gif, .jpg, .png and .tif formats. We strongly encourage you to consult the guidelines at http://s3-service-broker-live-19ea8b98-4d41-4cb4-be4c-d68f4963b7dd.s3.amazonaws.com/uploads/ckeditor/attachments/7822/3c_Final_artwork.pdf. They should be as small and simple as is compatible with clarity. All panels of a figure should be logically connected and assembled on a single page in a rectangular shape; any essential alignments (parts horizontal, vertical, spacings of stereo pairs, etc) should be indicated. Each panel of a multipart figure should be sized so that the whole figure can be proportionally reduced and reproduced on the printed page at the smallest size at which essential details are visible. Nature's standard figure sizes are either 9 or 18 cm wide; the maximum permitted height is 17 cm. You should arrange the panels to fit these widths while minimizing excess space around the panels. Tables should be prepared using the Table menu in Microsoft Word. As we must be able to edit the figures so that they conform to our house style, the submission of files that are incorrectly formatted, flattened, or of insufficient resolution may delay final acceptance of your manuscript. Any images, illustrations, etc that are reused must be identified so that the appropriate permission can be obtained and credit can be given.

IMAGE INTEGRITY: We strongly advise that you go carefully through all the data (including Extended Data and Supplementary Information) to ensure there are no accidental image/data duplications, other image manipulations or data errors. Such issues generally require correction after publication. Any image provided for publication, either in print or online (including Extended Data and Supplemental Information), may be subject to a quality control process to check for image integrity and manipulation. A discussion of our standards regarding how images should be prepared and presented can be found at https://www.nature.com/authors/editorial_policies/image.html.

EXTENDED DATA: Extended Data do not appear in print but are included online within the full-text HTML and integrated in the downloadable PDF. Extended Data are an integral part of the paper, and only data that directly contribute to the main message should be included. All Extended Data must be referred to in the main text, and their legends should be listed sequentially at the end of the main text, not in the Extended Data files. Extended Data should be assembled into a maximum of 10 A4 size, multi-panelled display items. They must be supplied as individual files in .jpg, .tif or .eps format only. They should be of the same quality as the main figures, but there are important differences in their formatting. More specific instructions are provided here: http://s3-service-broker-live-19ea8b98-4d41-4cb4-be4c-d68f4963b7dd.s3.amazonaws.com/uploads/ckeditor/attachments/7823/3h_Extended_data.pdf. We encourage authors who are describing complex processes to include a schematic of the main finding as part of the Extended Data to aid readers unfamiliar with the immediate discipline.

SUPPLEMENTARY INFORMATION: Supplementary Information (SI) is online-only, peer-reviewed material that is essential background to the study (e.g., large data sets, more complex methods, and calculations), but which is too large or impractical, or of interest only to a few specialists, to justify inclusion in the print version of the paper (see https://www.nature.com/nature/for-authors/supp-info for further details). While SI should not typically contain data figures (any figures additional to those appearing in the main text should be formatted as Extended Data), we require that the raw, uncropped data for gels be presented as an SI figure (see below). Tables may be included in SI, but only if they are unsuitable for formatting as Extended Data (e.g., tables containing large data sets or raw data tables that are best suited to Excel files). If a manuscript has SI, each discrete item of the SI (e.g., videos, tables) must be referred to at an appropriate point in the main manuscript. We ask that you provide a word file entitled “SI Guide”, containing a cover page with manuscript title and author information; a table of contents (preferably with page numbers); and then any SI text, notes, figures, and titles and legends for any separate SI files. Additional information can be found at https://www.nature.com/nature/for-authors/supp-info.

Please pay careful attention to the formatting of the SI because it is not subedited. After the paper has been accepted, SI files can only be amended for critical changes to the scientific content, not for style.

SOURCE DATA (GRAPHS): To increase transparency, we strongly encourage you to provide, in spreadsheet form, the data underlying the graphical representations used in figures. In the case of all experiments presenting data from animal models, this is a requirement and is not optional. This is in addition to our well-established data-deposition policy for specific types of experiments and large datasets. Online readers of the manuscript will be able to access the graphical source data directly from the figure legend. Spreadsheets must be submitted in .xls, .xlsx or .csv formats. One file per figure is permitted. If there is a multi-panelled figure, the source data for each panel should be clearly labeled in the file; alternatively the source data for a figure can be included in multiple, clearly labeled sheets within an Excel file. File sizes of up to 30 MB are permitted, but it is expected that the vast majority of graphical source data files will be considerably smaller than this. When submitting these files with your manuscript, you should select the "Source Data" file type and use the title field in the file description tab to indicate the figure(s) to which the source data pertain. Source data should not be provided as Extended Data.

DATA DEPOSITION: The following specific points may be relevant to your paper, so please ensure that you provide the following information:

CONSORTIA: For papers containing one or more consortia, all members of the consortium who contributed to the paper must be listed in the paper (i.e., print/online PDF). If necessary, individual authors can be listed in both the main author list and as a member of a consortium listed at the end of the paper. When submitting your revised manuscript via the online submission system, the consortium name should be entered as an author, together with the contact details of a nominated consortium representative. See https://www.nature.com/authors/policies/authorship.html for our authorship policy and https://www.nature.com/documents/nr-consortia-formatting.pdf for further consortia formatting guidelines, which should be adhered to prior to acceptance.

camerondow35 commented 2 years ago

Please ensure that the text size in all figures is at least 5 pt Arial.

Do you know how to change the font in an rmd table? I've tried changing font in the csv and adding mainfont = Arial / \fontspec{Arial} to the extended data rmd but neither seemed to work. It seems like the tables are the issue here.

Please let us know the sources of the map illustrations in extended data figures.

This is in reference to EFD1? That map is from ggplot2.

Figure 3 is too tall in height when re-sized to 18 cm width, please reduce to 17 cm or less.

Are they asking us to change the height to 17cm while the width will be 18cm? That would make the figure into a weird square...

teixeirak commented 2 years ago

Please ensure that the text size in all figures is at least 5 pt Arial.

Do you know how to change the font in an rmd table? I've tried changing font in the csv and adding mainfont = Arial / \fontspec{Arial} to the extended data rmd but neither seemed to work. It seems like the tables are the issue here.

Which looks suspicious to you? Presumably EDT3 (smallest font size of all)? I think that still looks bigger than some of the figures. Perhaps some of the font is getting smaller than programmed when the figure is shrunk to size? (Font and figure sizes can sure be annoying...)

teixeirak commented 2 years ago

Figure 3 is too tall in height when re-sized to 18 cm width, please reduce to 17 cm or less.

Are they asking us to change the height to 17cm while the width will be 18cm? That would make the figure into a weird square...

It sounds like that. It sure will crunch it down into an almost impossible size... Perhaps we should check with the editor? But I do think that's what's meant.

camerondow35 commented 2 years ago

Which looks suspicious to you? Presumably EDT3 (smallest font size of all)?

I think the font in all the tables needs to be changed, but the font size seems ok on first glance

teixeirak commented 2 years ago

Are you sure? The checklist says figures, not tables. To me it looks like the smallest fonts anywhere are the axis labels on EDF 3, probably followed by the index numbers on the 3 tree-ring plots. (Tables EDT1 and EDT2 have fonts bigger than the captions.)

camerondow35 commented 2 years ago

Are you sure?

It seems weird to have different font types for tables and figures, but you're right, they just mention figures.

the index numbers on the 3 tree-ring plots

These should be large enough in the original images, but may become too small because of the way we screenshot the final figure.

teixeirak commented 2 years ago

Oh no, I'm sorry... This whole time I've been thinking about font size, thinking you wanted me to make the table font bigger! That's just because I didn't read well. I'll look at this in the morning.

teixeirak commented 2 years ago

Please ensure that the text size in all figures is at least 5 pt Arial.

Do you know how to change the font in an rmd table? I've tried changing font in the csv and adding mainfont = Arial / \fontspec{Arial} to the extended data rmd but neither seemed to work. It seems like the tables are the issue here.

Which looks suspicious to you? Presumably EDT3 (smallest font size of all)? I think that still looks bigger than some of the figures. Perhaps some of the font is getting smaller than programmed when the figure is shrunk to size? (Font and figure sizes can sure be annoying...)

@camerondow35 , Are you sure that changing the font to Ariel is necessary? It looks like it's a tricky thing to do, so I'd rather not bother unless it's specifically requested. Are you basing this on the request "Please ensure that the text size in all figures is at least 5 pt Arial."? If so, I'd think that applies to the figures, and I wouldn't worry about the tables. They can always come back to us if this is a problem.

camerondow35 commented 2 years ago

Are you sure that changing the font to Ariel is necessary?

I'm not sure. So we can leave it alone for now.

camerondow35 commented 2 years ago

Figure 3 is too tall in height when re-sized to 18 cm width, please reduce to 17 cm or less.

See the commit I made a few days ago which I think solves this. I just resized it in powerpoint then saved the image manually (no screenshot)

Please supply Table 2b in the article file in an editable format. Does this refer to table in Figure 1b?

I guess. We have this already but the text is latex based, right? Is that a problem?

camerondow35 commented 2 years ago

Please ensure that the text size in all figures is at least 5 pt Arial. which don't meet this standard?

I think this is ok?

teixeirak commented 2 years ago

We have completed all but the SI guide, which is now it's own issue, so closing this.