youngmon/atlassian-qna huggingface dataset:
Real-life examples of beautiful technical documentation using Confluence
Asked by Todd:

This blog post was written several years ago: [https://www.atlassian.com/blog/add-ons/5-real-life-examples-beautiful-technical-documentation](https://www.linkedin.com/safety/go?url=https%3A%2F%2Fwww.atlassian.com%2Fblog%2Fadd-ons%2F5-real-life-examples-beautiful-technical-documentation&trk=flagship-messaging-web&messageThreadUrn=urn%3Ali%3AmessagingThread%3A2-NDI5ZmI5ZGUtYWNkNC00NGMyLWE0YTUtM2YzYjUzODllMDIwXzAxMA%3D%3D)

We use Atlassian enterprise (Confluence, Jira, Trello) extensively throughout my company. I am working on a massive initiative to consolidate and demystify our internal-facing documentation. Do any more recent examples exist of user-facing knowledge bases or technical documentation using Confluence? A few of those links are now either dead or pointing to sites that are no longer using Confluence.

I would love to stick to Confluence if possible but need some more inspiring sites to reference, where companies have gotten documentation right using Confluence.


Answers:
author: Brant Schroeder
body: [@Todd](/t5/user/viewprofilepage/user-id/5035917) Welcome to the Atlassian community

Confluence is a great tool for technical documentation. I think examples are helpful but what you really need to do is develop some standards of how you will organize your content, how it should be built out (Templates) and a process for creating and approving content.

Here is an articles KB about technical documentation. <https://confluence.atlassian.com/doc/develop-technical-documentation-in-confluence-226166494.html>

I wrote an article about knowledge bases that is very applicable to this. I have done similar steps when setting up documentation. <https://community.atlassian.com/t5/Confluence-articles/How-to-Use-Confluence-as-a-Knowledge-Base/ba-p/2129974>

comments: author: Todd
body: Thanks, Brant! This is very helpful, and I agree that there's a lot of fundamental work that needs to happen before the "chrome." My motivation for asking for real-world examples is to show people internally what's possible, to get them bought in on using Confluence for this reason. Some people might've had bad experiences with Confluence as a knowledge base because of poor digital hygiene, and that bias has to be overcome. It's easier to battle that by showing the end state that's possible. That all said, I will certainly study the helpful links you shared.


author: Brant Schroeder
body: [@Todd](/t5/user/viewprofilepage/user-id/5035917) makes sense. You might take a look at Teams 22 content. There might be some digital content that you could share. They have a bit of on-demand content that you can still watch. <https://events.atlassian.com/team22/on-demand-library>


Tags: cloud

confluence-cloud
Including identical content across multiple pages
Asked by Gregory Muir:

So I'm looking at this and am not sure if I've got a good idea or a bad idea.

So there's the Excerpt macro, only it applies once per source page though the destination page can invoke the excerpt macro from multiple source pages. If you put two macros on the source page, only the top one gets read.

So it looks like if I have multiple identical text fields to include across the multiple pages, each source will have to basically be a single page that is quoted and consists only of the material in the excerpt and that's one way to make it work.

I see there's a table excerpt that should let multiple calls come from one source page but that looks like it's mainly for the tabular data and mine is all paragraphs.

Do I have the best solution outside of paying for macros or is there a smarter way to do this I'm overlooking?


Answers:
author: Katerina Kovriga {Stiltsoft}
body: Hi [@Gregory Muir](/t5/user/viewprofilepage/user-id/4030884) ,

Our [Table Excerpt/Table Excerpt Include](https://docs.stiltsoft.com/display/public/TFAC/How+to+use+Table+Excerpt+and+Table+Excerpt+Include+macros?utm_source=atl_community&utm_medium=answer&utm_campaign=table-filter-traffic-sources&utm_vendorID=1216111) macros can build combined reports with meta data from reused tables indeed, but you can pull paragraphs as well - the Table Excerpt Include macro will collect any data that is contained within the Table Excerpt macros.

The "Table" part here is more of the brand: the app is called "[Table Filter and Charts for Confluence](https://marketplace.atlassian.com/apps/27447/table-filter-and-charts-for-confluence?tab=overview&hosting=cloud&utm_source=atl_community&utm_medium=answer&utm_campaign=table-filter-traffic-sources&utm_vendorID=1216111)", so our macros have the same name pattern: Table Filter, Table Spreadsheet, Table Excerpt, etc.

comments: author: Katerina Kovriga {Stiltsoft}
body: By the way, if your hosting is Cloud, it seems that the standard Excerpt macros have IDs (Excerpts' names) and can be pulled separately (not only the first one). For Server/Data Center this feature is not still introduced.


Tags: cloud

confluence-cloud

filter

table

table-excerpt

table-filter

table-filter-and-charts
Anchor links are still treated like External links
Asked by Andrea Bobick:

There is a bug (or undesirable feature) of anchor links being treated as external links. This results in anchors opening a new tab every time.

After a quick search I've seen other posts stating that this is still occurring in latest versions of Confluence.

Are there any plans to add an alternative behavior here?


Answers:
author: Brant Schroeder
body: [@Andrea Bobick](/t5/user/viewprofilepage/user-id/4722244) How are you structuring the link? Can you please share what the link string looks like?


Tags: cloud

confluence-cloud
Trying to insert a link through the browser
Asked by Kudzaiishe:

I have created a new page and inserted a table. When I select the link button, the only options that I am getting are other pages . I would like to have the option to link some documents in my local server onto the Confluence. I can do it with already existing pages but I don't know why I am not with this new page. Please help!


Answers:
author: Fabio Racobaldo _Herzum_
body: Hi [@Kudzaiishe](/t5/user/viewprofilepage/user-id/5035801) ,

welcome to the Atlassian community!

When you add a link through the link macro, you should be able to link other pages, attachments or a weblink.

In order to add a link to a local document you should be able to choose File and then select your local file. That file will be added as attachment to your page and linked in your page.

![Immagine.png](https://community.atlassian.com/t5/image/serverpage/image-id/217126i41B8148011FA25EE/image-dimensions/336x236?v=v2 "Immagine.png")

Is your link macro something like that?

Fabio

comments: author: Kudzaiishe
body: Hi Fabio

Many thanks for the welcome and response. My link macro for the old pages is like your image. However, the one for the new page that I created yesterday is different. It only displays previous pages as options.

Kudzaiishe


Tags: server
Creating a knowledge base for company that is login protected
Asked by Katie Scholl:

Hi,

My company is looking to create a knowledge base for our employees but we do not want these articles to be public facing and able to be accessed by anyone. However, we also do not want all of our company to have to set up their own login or be a "user" of confluence since they will just be reading the articles. Is there a way to have a login to confluence that is email based so anyone with my companies gmail address can login with their email?

Any information would be great! Thank you


Answers:
author: Brant Schroeder
body: [@Katie Scholl](/t5/user/viewprofilepage/user-id/4740301)

There are a couple of different ways to do this. Each has different pros and cons.

* If team members are not going to be updating and only using the pages read only you can setup a public space so no one has to login and a license is not required. Your subscription would need to be Premium and then you can use the IP allow list to only allow team members from a specific IP to access the public pages. You would want to use your companies network so team members on prem could connect and individual off prem could use a VPN to connect to the Confluence knowledge base.
* You can also couple Confluence with Jira Service Management and individuals can access the articles through the service desk. You can setup the service desk to only allow specific users to login as customers and see the articles. This would also be handy if you want to be able to provide the option of submitting support questions.
* You can setup Confluence to sync to your user directory (Google) and provide automatic access to Confluence. This would require each user to have a license which could be assigned automatically to all active users.

comments: author: Katie Scholl
body: Thank you! This is very helpful


Tags: cloud

confluence-cloud
Adding widget connector gives no output?
Asked by Chelsea Bright:

I want to add a youtube video to my confluence page, but when I use the Widget Connector Macro I do not get any output. The macro does not appear on my page in edit mode nor when I update the page. Any help would be appreciated :)


Answers:
author: Andy Gladstone
body: [@Chelsea Bright](/t5/user/viewprofilepage/user-id/5035667) welcome to the Atlassian Community. I am sorry that this answer has taken so long to be posted.

If you read through the [Widget Connector Macro](https://support.atlassian.com/confluence-cloud/docs/insert-the-widget-connector-macro/) documentation you will find that there are some limitations with YouTube videos. Clips or URLs that contain a specific start point will not render. When testing in my instance I was able to get any YouTube video to render as long as I was copying the actual URL from the browser. When I would try a specific start point, or use a clip it would not.

I hope this helps.

comments: author: Andy Gladstone
body: [@Chelsea Bright](/t5/user/viewprofilepage/user-id/5035667) if my answer helped you, please consider marking it by clicking the Accept answer button so that others may find it with more ease.
Single Space Guest Access
Asked by Jay Ali:

Hi

What is defined as a guest for this new upcoming feature?

As in it is only external guests (outside the organisation) that are allowed or can you invite internal (same domain as user) for guest access?


Answers:
author: Fabio Racobaldo _Herzum_
body: Hi [@Jay Ali](/t5/user/viewprofilepage/user-id/5035656) ,

here an useful article that could help you on that <https://support.atlassian.com/confluence-cloud/docs/invite-guests-for-external-collaboration/>

Hope this helps,

Fabio

comments: author: Jay Ali
body: Thank you [@Fabio Racobaldo _Herzum_](/t5/user/viewprofilepage/user-id/781528) the article provides the answers :)


author: Fabio Racobaldo _Herzum_
body: Please [@Jay Ali](/t5/user/viewprofilepage/user-id/5035656) mark my answer as accepted so that this thread can be considered closed


author: paolostermin
body: [@Fabio Racobaldo _Herzum_](/t5/user/viewprofilepage/user-id/781528) I don't see this feature available yet though. It is only from 1 October 2022 or should I be able to add guest users already? We are on Cloud, standard edition.


author: Davide Bonaciti
body: HI [@Fabio Racobaldo _Herzum_](/t5/user/viewprofilepage/user-id/781528)

Starting from yesterday I can set a user as Guest, but then on Global permissions I miss the section for managing Guests access.....

Any idea why?


author: Lance McIntosh
body: [@Davide Bonaciti](/t5/user/viewprofilepage/user-id/316055) I have the same issue, would appreciate it if anyone else knows why the "Guest" tab is not showing in the Global Permissions page?

EDIT

this morning the tab has shown up :D


author: Davide Bonaciti
body: This morning I also can see the tab, and feature is working :-)


Tags: cloud

confluence-cloud
I'd like to show 'todays date' on a page, how do I do this (without buying plugins)
Asked by Danny Derks:

I'm missing some very basic features in confluence cloud.   
I'd like to add todays date to a page (so I have a date listed when I export a KPI report to pdf).

I read a bit in the forum, but this seems to be only possible, if   
a) I buy some plugin, which I refuse to do for such basic functions.

b) Become a developer myself and create my own plugin.   

I think in general Confluence cloud misses some very basic functions to create your own macro's and automation functions in a straightforward way...   

Is there any straightforward way I can add 'todays date' to my confluence page? (not to a template, but a published page).


Answers:
author: Dylan Brotherton
body: I found this feature suggestion:  

<https://jira.atlassian.com/browse/CONFCLOUD-74864>  

I have been trying to solve this same issue. It would add value to my work, specifically adding Jira report filters. Those filters can easily handle dynamic dates, but trying to represent that in Confluence is not possible. As a non-admin user it is frustrating that all the "solutions" for this require admin-level access.


author: Alex Koxaras _Relational_
body: Hi [@Danny Derks](/t5/user/viewprofilepage/user-id/5012078)

Short answer is no. But you could do it manually though. It's about 4 clicks. I don't think that this "basic" feature you are asking would add additional value in Confluence. In my case and job it would be pretty useless. :/

But you could always [add this feature as a suggestion](https://jira.atlassian.com/issues/?filter=98690), vote it, watch it and ask from other users to do the same.


Tags: cloud

confluence-cloud
can I use multiple files to attach in one command in rest API
Asked by ramesh kumar:

Hi Team,  

I got this command to upload an attachment. Can i use 3 file names separated by commas using below comand?  

curl -u $USER_NAME:$USER_PASSWORD \\

-X POST \\

-H "X-Atlassian-Token: nocheck" -F "file=@${ATTACHMENT_FILE_NAME}" -F "comment=File attached via REST API" \\

${CONFLUENCE_BASE_URL}/rest/api/content/${PAGE_ID}/child/attachment 2\>/dev/null   

If NO what is the best way (other than running a loop) to attach all 3 files with a single command to a confluence page?


Answers:
author: Rachi Manwal
body: [@ramesh kumar](/t5/user/viewprofilepage/user-id/4808100) Were you able to attach multiple files at once?


Tags: cloud

confluence-cloud
Can't edit page because it is "popular" and open by me many times. Even though I have only one tab
Asked by marina:

Sometimes it can be fixed by itself in the question of some hours and sometimes of days. It is very annoying when I have created a document and can't work on it or share it with a team.![Screenshot 2022-09-20 at 16.02.37.png](https://community.atlassian.com/t5/image/serverpage/image-id/216819i4334A80C1721A456/image-size/large?v=v2&px=999 "Screenshot 2022-09-20 at 16.02.37.png")


Answers:
author: Nic Brough -Adaptavist-
body: Welcome to the Atlassian Community!

Try closing your browser, and clearing the caches and cookies. The browser can collect multiple sessions (especially when you've left for a while and come back, and had to log in again), and this can lead to what you're seeing.


Tags: cloud

confluence-cloud
How can I delete the page which I have created?
Asked by sangeetha sunitha:

How can I delete the page which I have created?


Answers:
author: Andy Gladstone
body: [@sangeetha sunitha](/t5/user/viewprofilepage/user-id/5035477) Welcome to the Atlassian Community!

There was an article about this published JUST THIS MORNING! Here you go, and Kudos to [@Zoriana Bogutska_Adaptavist_](/t5/user/viewprofilepage/user-id/5015547)

[https://community.atlassian.com/t5/Confluence-articles/Deleting-a-page-in-Confluence/ba-p/2139778?utm_source=atlcomm\&utm_medium=email\&utm_campaign=immediate_general_article\&utm_content=topic](https://community.atlassian.com/t5/Confluence-articles/Deleting-a-page-in-Confluence/ba-p/2139778?utm_source=atlcomm&utm_medium=email&utm_campaign=immediate_general_article&utm_content=topic)

Good luck!

comments: author: Andy Gladstone
body: [@sangeetha sunitha](/t5/user/viewprofilepage/user-id/5035477) checking in here to see if my answer helped you. If it did, please mark it as Accepted so that others looking for similar content can more easily find it.
Accessing the response from Jira Story created with Confiforms via Jira Server application link
Asked by Grady Anderson:

Does Jira typically return any information when it receives a post from Confluence, and if it does, how do I 'get' to it?

I am using Confiforms IFTTTmacro to create a Jira story. The story is created no problem but I need the link or id of the newly created story to be available in Confluence. I don't have full developer/administrator access to Confluence or Jira so I can really see what's going on on either side. I have looked at the network traffic in my browser dev tools and do not see anything that looks like a response from Jira.

Thanks for any advice you can offer!


Answers:
author: Alex Medved _ConfiForms_
body: Hi

You can check this [tutorial](https://wiki.vertuna.com/display/TEST/Create+Jira+issue%2C+save+the+created+Jira+key+back+to+ConfiForms+and+create+a+page+with+Jira+macro)

And as long as you write back the created Jira issue key to the Jira issue field - you will be able to access directly [any field that your Jira issue has](https://wiki.vertuna.com/display/CONFIFORMS/Accessing+Jira+issue+fields+directly+from+ConfiForms+using+Jira+issue+field)

Alex

comments: author: Grady Anderson
body: Thank you for your prompt response. That tutorial was a huge help.

I have one more question... My jira implementation returns this json for our story issueLinks definition, the operations element lists only "add" and I have been unsucessfull in sending links to this array with ifttt macros. Should I be able to add links with an ifttt macro?

issuelinks: {  
required: false,  
schema: {  
type: "array",  
items: "issuelinks",  
system: "issuelinks"  
},  
name: "Linked Issues",  
key: "issuelinks",  
autoCompleteUrl: "",  
hasDefaultValue: false,  
operations: \[  
"add"  
\]  
},


author: Alex Medved _ConfiForms_
body: Sorry, not sure I understand... Are you trying to create remote links via REST API?

<https://docs.atlassian.com/software/jira/docs/api/REST/7.6.1/#api/2/issue-createOrUpdateRemoteIssueLink> ?

Alex


author: Grady Anderson
body: I don't think so, I am trying to add a linked issue to a story. I believe they are called IssueLinks or LinkedIssue.

I actually found a thread here which suggested using this:

"update":{ "issuelinks":\[ { "add":{ "type":{ "name":"Blocks", "inward":"is blocked by", "outward":"blocks" }, "outwardIssue":{ "key":"TEST-1" } } } \] }

but I am getting this response from Jira:

* com.atlassian.sal.api.net.ResponseException: Error communicating with Jira, {"errorMessages":\["Issue Does Not Exist"\],"errors":{}}

Does this mean that it will only accept a link to an existing item or that the issueLink type must be defined somewhere else first?


author: Alex Medved _ConfiForms_
body: Sorry, I have no ideas what these are... but if you know how to do it via REST api then this also doable via ConfiForms...

But the error you see seems to tell you that the issues under TEST-1 key does not exist in you Jira instance


Tags: application-link

confiforms

confluence-server

issue-create

jira-server

server
Confluence Upgrade Path From 5.9.4 to 7.19.1
Asked by Ahmet A:

I want to upgrade my Confluence Server version. How do I upgrade from 5.9.4 to 7.19.1 installed in Windows Server 2016 environment? I request your help.

Kind regards.


Answers:
author: AAMIR ANSARI
body: Hi [@Ahmet A](/t5/user/viewprofilepage/user-id/4761528)

Although the confluence [doc](https://confluence.atlassian.com/conf72/confluence-upgrade-matrix-982324055.html) says that you can directly perform the upgrade from 5.0 to 7.x, I would suggest otherwise based on my experience. Since there are significant changes done between version 5 to version 7 like Collaborative editing feature, analytics etc, many new tables and constraints were introduced from confluence version 6.x onwards. Mostly I have seen failures due to new database tables and constraints.

I will suggest you follow the upgrade path 5.x--\>6.x--\>7.x. Also please be sure to take into account supported platforms as suggested by Dave above.

Thanks,

Aamir

comments: author: Ahmet A
body: Hi [@AAMIR ANSARI](/t5/user/viewprofilepage/user-id/4992440) Thanks for your help. First, I upgraded to version 6.5.3. Do you mind if I upgrade to 7.19.1(LTS) afterwards? Is there any difference between LTS versions and others?


author: AAMIR ANSARI
body: Hi, [@Ahmet A](/t5/user/viewprofilepage/user-id/4761528) Glad to hear that you have upgraded to version 6.5.3. Most of the issues are encountered during the upgrade from version 5 to version 6. Since you have passed this hurdle, you can now directly upgrade to 7.19.1.

Regarding LTS versions, you can read the details below, but in a crux, in LTS versions, you can backport all other security bug fixes to Long Term Support releases throughout its standard [2-year support window](https://confluence.atlassian.com/support/atlassian-support-end-of-life-policy-201851003.html)

* <https://confluence.atlassian.com/enterprise/long-term-support-releases-948227420.html>

Regards,

Aamir


author: Ahmet A
body: Hi, [@AAMIR ANSARI](/t5/user/viewprofilepage/user-id/4992440) Thanks.


author: Dave Mathijs
body: Hi [@Ahmet A](/t5/user/viewprofilepage/user-id/4761528)

From version 5.0 to 7.x, you can upgrade directly to the latest version of Confluence 7, but take into account supported platforms. This is of course only possible when you have a valid maintenance license.

comments: author: Ahmet A
body: Hi [@Dave Mathijs](/t5/user/viewprofilepage/user-id/2662590) Thanks for your help.


Tags: confluence-server

path

server

upgrade
Managing a knowledge base in confluence space
Asked by Oxana Ermolaeva:

Hi, everyone. I have a knowledge base in my Help Desk space which is connected to my Jira Help Desk project. I want to start to fulfill it. I want to build a user-friendly structure for this. Like I want to have a main page with search bar and hyper links of FAQs article page and other important pages like How-to articles, troubleshooting articles and so on. And the main point is that I want this main page to be the first page is opened when customers open this space, and then they can go to other pages by clicking the links.

I also have a question about how my articles will be displayed in Jira. It wont be a main page? And all articles will be just displayed as a list in portal? I would like my customers to have the same main page as in Confluence for easier access to articles.

I hope I made my intentions clear and will be very glad if you could help me and explain everything in a detail.


Answers:
author: Alex Koxaras _Relational_
body: Hi [@Oxana Ermolaeva](/t5/user/viewprofilepage/user-id/5025042)

I think it's best if you could invest some time reading a few articles:

* <https://www.atlassian.com/software/confluence/guides/expand-confluence/confluence-and-jira-service-management#recommendations>
* <https://www.atlassian.com/itsm/knowledge-management/self-service-success>
* <https://www.atlassian.com/blog/archives/5_tips_for_building_a_knowledge_base_with_confluence>
* <https://support.atlassian.com/jira-service-management-cloud/docs/link-confluence-spaces-to-your-service-project/>


Tags: cloud

confluence-cloud

faq

knowledge-base

space