How to do cross-references in SciFlow

SciFlow is one of several options when it comes to collaborative writing. I like the intuitive interface, but sometimes it can be hard to see some useful features built in — like cross-references to other sections and figures/tables. This is super easy in SciFlow.

Let’s start with a new document. In this example, I have two sections on the left, with a table in Section 2. I have also pressed the “outline” button to see the document outline on the right.

In this example, I want to add a cross-reference to section 2 at the end of the “Main text” section. I simply select the section I want to refer to on the right

and drop it in the text where I want the cross-reference to appear.

Here we go, the placeholder for the cross-reference is included.

We can cross-reference figures and tables in the same way. Select the figure or table on the right (note the “Figures, Tables & Equations” below the list of sections),

and drag it

into the main text:

At the time of writing, the placeholder makes no distinction between figures and tables, but it’s just a placeholder…

A bit like when using LaTeX, in SciFlow you use “What You See is What You Mean”, so the output will probably look different from what you have on the screen. Indeed, this is a strength of SciFlow, both in that it allows you to export in many formats, and in that it prevents you from spending hours tinkering with the formatting. Unlike some other online editors, SciFlow is good at producing Word documents that are commonplace in the social sciences (many journals insist on a Word document during submission), or PDF, as you like. You choose the style and can readily change that style because SciFlow separates content from form.

Here’s that little section in one style:

and here in another style:

There you go, placeholders replaced with the relevant text depending on the template used.

Could not connect to SciFlow

In the past few days, I could not log into SciFlow:

Something went wrong.
No session found

Please try again. If the problem persist, please reach out to
support@sciflow.net.

Well, I did contact the excellent customer service, and it turns out that they tweaked their cookie settings. Which simply means: clear out your SciFlow cookies, and keep writing!

The reviewer raises an important point…

It’s common practice to respond to reviewer comments with the phrase “The reviewer raises an important point”, I’ve seen it recommended on many occasions. Today, I had this following gem:

Me (aka reviewer 1): Major point ….

Response: The reviewer raises an important point …

Didn’t I just say so?

Academic writing: the one book you really need

There is no shortage of books on academic writing. If you cannot decide where to start, in my view, you should start with “Write No Matter What” by Joli Jensen. Here’s why:

  • it’s relatively short
  • it summarizes the best advice out there
  • it’s realistic

Like other books on academic writing, it starts by addressing common myths about academic writing. I find it painful to see these myths repeated in my own environment. In Jensen’s book, you’ll learn three taming techniques (creating a project box, using a ventilation file, and writing at least 15 minutes every day). So we’re looking at being organized, being realistic (i.e. having room for frustration, writing blocks, etc.), and that important continuing contact with the writing project.

Compared to other similar books I know, I really liked how “Write No Matter What” does not imply that if only you were more disciplined, you’d get all that writing done. No, instead there is an entire section on maintaining momentum, lost trails, and handling revisions and rejections. Getting stalled? There’s an entire chapter on that.

I didn’t enjoy the chapters on writing support that much, but if you’re looking into setting up a campus-wide (or even faculty-wide) writing support, you’ll get plenty of ideas what may or may not work.

Writing style is explicitly not covered, and I think that’s a good thing. Not that books on good writing were redundant — to the contrary! — but this way we get a focused book that can serve everyone from a first-year PhD student to established faculty.

Tweaking Pomodoro

What is known as the pomodoro technique is a common time management method. Set your (kitchen) timer to 25 minutes, and work until time is up. Take a short break and repeat. There is no particular reason for setting the time to 25 minutes, though, except that the person popularizing this particular variant used 25 minutes. I have recently discussed this with a friend, mentioning that I often use this with much shorter periods, like 10 minutes. I do this, when I need to get started — the first 2 minutes of writing tend to be the hardest one. On the other hand, once I get into the flow, I find any solution with popups or audible sounds (i.e. almost all of those I know) quite distracting. Perhaps I’m calling for a timer that starts with 10 minutes and then automatically sets itself to 20 or 40 minutes to motivate me to keep going?

Image credit: CC-BY Lenore Edman.